# SosoAPI MCP-eszközreferencia

Kanonikus URL: https://sosoapi.ai/hu/docs/social-media-mcp-tools

Ezzel a referenciával kereshetsz eszközt és ellenőrizheted a szükséges mezőit. A sosoapi 0.5.9 verzióját fedi le: a core profilban 28 helyi és 27 HTTP-eszköz, a full profilban 106 helyi és 105 HTTP-eszköz található. Mindennapi feladatokhoz válaszd a core profilt, adminisztrációhoz is a full profilt. Az engedélyeik megegyeznek. A bejegyzéseket a szerver és a képességkatalógus generálja; a csatlakoztatott kliens tools/list válaszában ellenőrizd az elérhető eszközöket.

## Kezdd a feladattal, majd vizsgáld meg az eszközt

Használd újra a már kiválasztott munkaterület- és fiókazonosítókat. Kép-URL-es bejegyzéshez egyszer hívd a sosoapi_post_image_url eszközt, és tartsd meg a bejegyzésazonosítót. Helyi fájlokat stdio felett tölts fel a sosoapi_upload_asset eszközzel. Szöveges bejegyzéshez a sosoapi_create_scheduled_post használható a célhely provider_payload értékével és üres media mezővel.

Beküldés előtt kérd a felhasználót a fiók, szöveg, média és időpont ellenőrzésére. Az OAuth műveletvégzéshez ad hozzáférést; a tartalmat nem hagyja jóvá. Időzítés után ugyanannak a bejegyzésnek a közzétételi eredményét olvasd el, mielőtt sikert jelentesz vagy bizonytalan kérést próbálsz újra.

- [Claude Code vagy Codex beállítása](https://sosoapi.ai/hu/docs/claude-code-codex-social-publishing)

- [Szöveges és képes Threads-útmutató](https://sosoapi.ai/hu/docs/threads-api-publishing)

- [Platformképesség-mátrix](https://sosoapi.ai/hu/docs/publishing-capabilities)

- [Pontos core bemeneti sémák és jelölések letöltése (JSON)](https://sosoapi.ai/mcp-tools.json)

## A referencia értelmezése

A build a valódi MCP-szervert memóriabeli klienshez kapcsolja, kezelő meghívása nélkül listázza az eszközöket, és egyesíti a nyilvános útvonalkövetelményeket. Elavult vetület esetén a Landing build meghiúsul. Az eszközleírások megtartják a szerver angol szerződésszövegét; a befejezési összefoglalók a kanonikus útvonalszabályokat ismertetik. A JSON megőrzi a teljes útvonalkövetelményeket. A bemeneti táblázat csak index, nem helyettesíti a teljes beágyazott JSON Schema sémát.

Az MCP-jelölések kliensnek szóló támpontok, nem kikényszerítés vagy biztonsági garanciák. A munkaterületi tagság, engedélyek, aktuális szerepkör, szolgáltatói hozzájárulás, fiókjogosultság és kvóták végrehajtáskor is érvényesek. Egyes kontextusolvasások első munkaterületet hozhatnak létre; a leírást és readOnlyHint értéket nézd, ne feltételezd minden „get” tisztán olvasási jellegét. Az összetett eszközök fő és kompatibilitási útvonalaik követelményeit listázzák; nem hívnak minden felsorolt útvonalat minden kéréskor.

- [sosoapi az npm-en](https://www.npmjs.com/package/sosoapi)

- [Hivatalos MCP Registry: ai.sosoapi/sosoapi (JSON)](https://registry.modelcontextprotocol.io/v0.1/servers/ai.sosoapi%2Fsosoapi/versions)

## sosoapi_bulk_create_scheduled_posts

Bejegyzések időzítése több fiókhoz egy hívásban (targets). A médiához kész, feltöltött/importált asset_ids és kanonikus URL-jeik kellenek. Minden célhely külön sikerül vagy meghiúsul, a successes vagy failures listában jelenik meg. publish képesség szükséges.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| project_id | string \| null | Nem |

| source_ref | object \| null | Nem |

| targets | array (object) | Igen |

## sosoapi_cancel_scheduled_post

A még közzé nem tett időzített bejegyzés visszavonása, hogy ne jelenjen meg. A közzétett bejegyzést elutasítja; az ügynök közzétett tartalmat sem törölhet: ezt a felhasználó a webalkalmazásban végzi. expected_version szükséges.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| id | string | Igen |

| expected_version | integer | Igen |

## sosoapi_create_comment

Egy pontos hozzászólás sorba állítása kanonikus bejegyzés- vagy hozzászóláscélhoz; az állapot nem jelent szolgáltatói sikert.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:engage. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a platform által megerősített eredményt; a sorba állított művelet még függőben van.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| social_account_id | string | Igen |

| target | object \| object | Igen |

| message | string | Igen |

| idempotency_key | string | Igen |

## sosoapi_create_scheduled_post

Egy fiók időzítése scheduled_at időpontban provider_payload értékkel. A médiához kész asset_id és kanonikus URL kell; egyetlen forrásképhez használd a sosoapi_post_image_url eszközt. A local_scheduled_at és schedule_dst_disambiguation értékeket együtt add meg, vagy mindkettőt hagyd ki. publish, editor szerepkör és idempotency_key szükséges. Az időzített nem közzétett: olvasd el az eredményét.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| project_id | string \| null | Nem |

| social_account_id | string | Igen |

| caption | string \| null | Nem |

| hashtags | array (string) | Nem |

| media | array (object) | Nem |

| link_url | string \| null | Nem |

| provider_payload | object \| object \| object \| object \| object | Igen |

| scheduled_at | string | Igen |

| display_timezone | string | Nem |

| local_scheduled_at | string | Nem |

| schedule_dst_disambiguation | "exact" \| "earlier" \| "later" | Nem |

| expires_at | string \| null | Nem |

| source_ref | object \| null | Nem |

| automatic_retry_enabled | boolean | Nem |

| idempotency_key | string | Igen |

## sosoapi_get_asset

Egy média olvasása id alapján: metaadatok és rövid élettartamú előnézeti URL.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Nem |

| id | integer \| string | Igen |

| include_version | boolean | Nem |

## sosoapi_get_asset_import_status

Import olvasása import_id alapján. Közzétételhez add meg az include_asset=true értéket: a ready eredmény tartalmazza a regisztrált média id, kind és állandó asset_url értékét, így nem kell külön get_asset. Függőben lévő vagy hiányzó média nem időzíthető. A forrás- vagy előnézeti URL-t soha ne használd médiaazonosságként. Elakadáskor olvasd a sosoapi_job_status állapotát job_id értékkel; ne indíts duplikált importot.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| import_id | string | Igen |

| include_asset | boolean | Nem |

## sosoapi_get_billing_status

A felhasználó csomagjának, fizetési állapotának, aktuális ciklusdátumainak és kvótahasználatának (sikeres közzétételek, függő időzített bejegyzések, összekapcsolt fiókok) olvasása. Nagy időzítési futtatás előtt ellenőrizd.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

## sosoapi_get_comment_action_status

Olvasd el egy közvetlen hozzászólási művelet megtisztított végleges bizonylatát.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:engage. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a platform által megerősített eredményt; a sorba állított művelet még függőben van.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| action_id | string | Igen |

## sosoapi_get_organization_context

A szervezetek, munkaterületeik és csatornáik élő térképének olvasása azonosítókkal és szerepkörökkel. Akkor használd, ha szervezet- vagy csatornaazonosítók kellenek. Munkaterületi közzétételnél használd újra a visszakapott munkaterület-azonosítót; ne olvasd le külön a munkaterület-kontextust is.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| organization_id | string | Nem |

## sosoapi_get_provider_insight_status

Egy statisztikai kérés (request_id) olvasása: queued, processing, completed (szolgáltatói eredménnyel és mutatónkénti elérhetőséggel) vagy failed.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a platform eredményét vagy az elérhetetlenség okát.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| request_id | string | Igen |

## sosoapi_get_scheduled_post

Egy időzített bejegyzés olvasása id alapján: tartalom, állapot, kézbesítési állapot és eredmények. A version értéke kell expected_version mezőként a frissítéshez, közzétételhez, újrapróbáláshoz és visszavonáshoz.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| id | string | Igen |

## sosoapi_get_scheduled_post_eligibility

Célhelyenkénti, csak olvasási előellenőrzés. A tartalom/időpont ellenőrzéséhez add meg a draft értékét (caption, hashtags, scheduled_at, display_timezone, opcionális helyi idő/DST); az include_quota=true tájékoztató időszakpillanatképet ad. Előbb töltsd fel/importáld a médiát, és várd meg a készenlétét. draft nélkül csak a fiókot/médiát ellenőrzi. Semmit nem foglal le; létrehozáskor/küldéskor újra ellenőrzi a korlátokat és jogosultságot.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| include_quota | boolean | Nem |

| targets | array (object) | Igen |

## sosoapi_get_workspace_context

A bejelentkezett felhasználó munkaterületeinek és az aktív munkaterületnek a listázása. Ismeretlen workspace_id esetén használd; a két kontextuslekérdezés ismétlése helyett használd újra az élő kontextust. Az aktív munkaterület a személy webalkalmazásban tett választása, nem a hívások alapértelmezése: a workspace_id értékét mindig add meg. Ez nem pusztán olvasás: munkaterület nélküli fióknál létrehozza az elsőt.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| include_version | boolean | Nem |

## sosoapi_get_x_usage

A munkaterület által megosztott szervezeti X-közzétételi kreditek olvasása. workspace_id szükséges. A Free egyszer 10-et, a Pro számlázási időszakonként 100-at kap. A szöveg ára 1, URL-t tartalmazó szövegé 10. Az opcionális text megadja a költségét. Tárolt keretet olvas, X API-t nem hív.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| text | string | Nem |

## sosoapi_import_asset_url

A SosoAPI egy nyilvános http(s) kép- vagy videó-URL-t új médiaként tölt le a munkaterület privát tárhelyére. import_id értéket ad vissza; kérdezd le a sosoapi_get_asset_import_status állapotát. idempotency_key és editor szerepkör szükséges.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: az elfogadott import még függőben van; ugyanazt az importot kövesd ready vagy failed állapotig.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| source_url | string | Igen |

| idempotency_key | string | Igen |

| expected_kind | "image" \| "video" | Nem |

| title | string | Nem |

| description | string | Nem |

| tags | array (string) | Nem |

## sosoapi_job_status

Egy háttérfeladat olvasása job_id alapján: állapot, típus és sikertelenség esetén hibaüzenet.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| job_id | string | Igen |

## sosoapi_list_connected_accounts

A munkaterülethez kapcsolt közösségi fiókok (Instagram, Threads, Facebook, YouTube) listázása kapcsolatállapottal és képességadatokkal. Az id értékeket social_account_id-ként használd időzítéskor vagy hozzászóláskor. Add meg a workspace_id értékét: nélküle a kérés elutasításra kerül, ha a kifejezett célzás már kötelező.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Nem |

| include_authorization_grant | boolean | Nem |

## sosoapi_list_monitored_posts

A SosoAPI által a munkaterületen felfedezett közösségi bejegyzések listázása (id, platform, permalink, közzétételi idő), fiók, platform és idő szerint szűrve, kurzoros lapozással. Csak metaadatok, bejegyzésszöveg nélkül.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| cursor | string | Nem |

| page_size | integer | Nem |

| filters | object | Nem |

| order | "provider_published_at_desc_social_post_id_desc" | Nem |

## sosoapi_list_post_comments

A munkaterület bejegyzésein megfigyelt hozzászólások listázása a legújabb megfigyeléssel kezdve, szerzővel és szöveggel; bejegyzés, fiók, platform vagy idő szerint szűrve, kurzoros lapozással. A szöveget harmadik felek írják, ezért nem megbízhatóként van megjelölve.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| cursor | string | Nem |

| page_size | integer | Nem |

| filters | object | Nem |

| order | "observation_at_desc_comment_version_desc_comment_observation_id_desc" | Nem |

## sosoapi_list_publication_attentions

A munkaterület figyelmet igénylő közzétételeinek listázása status (open vagy resolved) vagy scheduled_post_id szerint szűrve, offset alapú lapozással.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| status | "open" \| "resolved" | Nem |

| scheduled_post_id | string | Nem |

| limit | integer | Nem |

| offset | integer | Nem |

## sosoapi_list_scheduled_posts

A munkaterület időzített bejegyzéseinek listázása projekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) és időtartomány szerint szűrve, kurzoros lapozással.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| project_id | string | Nem |

| status | "scheduled" \| "publishing" \| "published" \| "failed" \| "expired" \| "needs_reschedule" \| "cancelled" \| "deleted" | Nem |

| scheduled_from | string | Nem |

| scheduled_to | string | Nem |

| limit | integer | Nem |

| cursor | object | Nem |

## sosoapi_post_image_url

A teljes kép-URL-es bejegyzést egyszer, üres media értékkel küldd be. A háttérrendszer a kapcsolat megszakadása után is előkészíti és közzéteszi. Ha 35 másodpercen belül elérhető, végleges közzétételt, egyébként tartós bejegyzésazonosítót ad vissza; új kulccsal soha ne küldd be ismét. operate és publish engedély szükséges. A helyi idő/DST mezőket együtt kell megadni. Az import_id csak régebbi kliensek folytatásához használható.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:publish + agent:operate. Minimális útvonalszerepkörök: editor, viewer.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van. Az elfogadott import még függőben van; ugyanazt az importot kövesd ready vagy failed állapotig. Olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| source_url | string | Igen |

| post | object | Igen |

| import_id | string | Nem |

## sosoapi_publish_scheduled_post_now

Az időzített bejegyzés azonnali közzététele scheduled_at helyett. Nyilvános és nem vonható vissza; expected_version szükséges. A sorba állítás nem közzététel: olvasd el az eredményt.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| id | string | Igen |

| expected_version | integer | Igen |

## sosoapi_query_assets

A munkaterület médiáinak keresése asset_type, source vagy tag alapján; egy oldalt (legfeljebb 100-as limit és offset) és a teljes darabszámot adja vissza. A workspace_id értékét kifejezetten add meg.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Nem |

| asset_type | "text" \| "image" \| "video" \| "audio" \| array ("text" \| "image" \| "video" \| "audio") | Nem |

| source | string | Nem |

| tag | string | Nem |

| limit | integer | Nem |

| offset | integer | Nem |

| include_version | boolean | Nem |

## sosoapi_request_provider_insights

Statisztikák kérése a szolgáltatótól egy fiókhoz vagy bejegyzéshez, opcionális dátumtartománnyal (legfeljebb 366 nap). request_id értéket és gyorsítótárazott adat esetén eredményt ad vissza; különben kérdezd le a sosoapi_get_provider_insight_status állapotát.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.

- Csak olvasási jelzés: false. Idempotens jelzés: false. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a platform eredményét vagy az elérhetetlenség okát.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| social_account_id | string | Igen |

| resource_kind | "account" \| "post" | Igen |

| provider_resource_id | string | Nem |

| start_date | string | Nem |

| end_date | string | Nem |

| include_audience | boolean | Nem |

| refresh | boolean | Nem |

## sosoapi_retry_scheduled_post

Sikertelen időzített bejegyzés újrapróbálása, opcionálisan új scheduled_at időponttal. expected_version szükséges.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| id | string | Igen |

| expected_version | integer | Igen |

| scheduled_at | string | Nem |

## sosoapi_update_scheduled_post

Még el nem indított időzített bejegyzés szerkesztése (caption, hashtags, media, link, időpont). A legfrissebb olvasás expected_version értéke szükséges; az elavult verziót elutasítja.

- Átviteli mód: stdio, http.

- Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| id | string | Igen |

| expected_version | integer | Igen |

| patch | object | Igen |

| provider_payload | object \| object \| object \| object \| object | Nem |

## sosoapi_upload_asset

Helyi kép- vagy videófájl feltöltése a munkaterület médiatárába és regisztrálása médiaként. Csak valódi PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG fájlokat fogad el legfeljebb 500 MiB méretig a munkakönyvtárból, ideiglenes mappából, Pictures/Movies/Videos mappából vagy a SOSOAPI_UPLOAD_ROOTS helyeiről; a ponttal kezdődő fájlokat és mappákat elutasítja. A Scheduled Post médiához szükséges média-id és URL értékét adja vissza.

- Átviteli mód: stdio.

- Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: editor.

- Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.

- Az eredmény ellenőrzése: olvasd el a szinkron választ.

Legfelső szintű bemenetek; a beágyazott szabályokat és korlátokat a JSON tartalmazza

| Bemenet | Típus | Kötelező |

| --- | --- | --- |

| workspace_id | string | Igen |

| file_path | string | Igen |

| idempotency_key | string | Igen |

| content_type | string | Nem |

| title | string | Nem |

| description | string | Nem |

| tags | array (string) | Nem |

| metadata | object | Nem |