# SosoAPI MCP-verktygsreferens

Kanonisk URL: https://sosoapi.ai/sv/docs/social-media-mcp-tools

Använd referensen för att hitta ett verktyg och kontrollera vilka fält det behöver. Den omfattar sosoapi 0.5.9: profilen core har 28 lokala verktyg och 27 via HTTP; full har 106 lokala och 105 via HTTP. Välj core för vardagliga uppgifter eller full för att även administrera. Båda använder samma behörigheter. Posterna genereras från servern och funktionskatalogen; kontrollera den anslutna klientens tools/list för att se vilka verktyg den har tillgång till.

## Börja med uppgiften och granska sedan verktyget

Återanvänd arbetsyte- och konto-ID:n som du redan har valt. För ett bild-URL-inlägg anropar du sosoapi_post_image_url en gång och behåller returnerat inläggs-ID. Ladda upp lokala filer med sosoapi_upload_asset via stdio. För ett textinlägg använder du sosoapi_create_scheduled_post med destinationens provider_payload och tomt media.

Be användaren granska konto, text, medier och tid före inskickning. OAuth ger åtkomst att utföra åtgärder; det godkänner inte innehållet. Läs samma inläggs publiceringsresultat efter schemaläggning innan du rapporterar framgång eller gör om ett anrop med osäkert resultat.

- [Konfigurera Claude Code eller Codex](https://sosoapi.ai/sv/docs/claude-code-codex-social-publishing)

- [Guide för text och bild på Threads](https://sosoapi.ai/sv/docs/threads-api-publishing)

- [Plattformsfunktionsmatris](https://sosoapi.ai/sv/docs/publishing-capabilities)

- [Ladda ned exakta core-indatascheman och annoteringar (JSON)](https://sosoapi.ai/mcp-tools.json)

## Så tolkar du referensen

Bygget ansluter den verkliga MCP-servern till en klient i minnet, listar dess verktyg utan att anropa någon hanterare och sammanfogar kraven för offentliga rutter. En inaktuell projektion får Landing-bygget att misslyckas. Verktygsbeskrivningarna behåller serverns engelska kontraktstext; slutförandesammanfattningarna förklarar de kanoniska ruttreglerna. JSON bevarar fullständiga ruttkrav. Indatatabellen är ett index, inte en ersättning för det fullständiga nästlade JSON Schema.

MCP-annoteringar är ledtrådar för klienter, inte tillämpning eller säkerhetsgarantier. Arbetsytemedlemskap, behörigheter, aktuell roll, leverantörssamtycke, kontobehörighet och kvoter gäller fortfarande vid körning. Vissa kontextläsningar kan skapa en första arbetsyta; granska beskrivningen och readOnlyHint i stället för att anta att varje ”get” är en ren läsning. Sammansatta verktyg listar krav för sina huvud- och kompatibilitetsrutter; de anropar inte varje listad rutt vid varje begäran.

- [sosoapi på npm](https://www.npmjs.com/package/sosoapi)

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

## sosoapi_bulk_create_scheduled_posts

Schemalägg inlägg för flera konton i ett anrop (targets). Medier behöver färdiga uppladdade/importerade asset_ids och deras kanoniska URL:er. Varje mål lyckas eller misslyckas separat och rapporteras i successes eller failures. Kräver funktionen publish.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| project_id | string \| null | Nej |

| source_ref | object \| null | Nej |

| targets | array (object) | Ja |

## sosoapi_cancel_scheduled_post

Avbryt ett schemalagt inlägg som ännu inte publicerats så att det aldrig skickas. Ett publicerat inlägg avvisas och en agent kan inte heller ta bort publicerat innehåll: användaren gör det i webbappen. Kräver expected_version.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| id | string | Ja |

| expected_version | integer | Ja |

## sosoapi_create_comment

Köa en exakt kommentar mot ett kanoniskt mål i form av ett inlägg eller en kommentar; status är inte framgång hos leverantören.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:engage. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det plattformsbekräftade resultatet; en köad åtgärd väntar fortfarande.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| social_account_id | string | Ja |

| target | object \| object | Ja |

| message | string | Ja |

| idempotency_key | string | Ja |

## sosoapi_create_scheduled_post

Schemalägg ett konto vid scheduled_at med provider_payload. Medier behöver ett färdigt asset_id och en kanonisk URL; använd sosoapi_post_image_url för en källbild. Para ihop local_scheduled_at med schedule_dst_disambiguation eller utelämna båda. Kräver publish, rollen editor och idempotency_key. Schemalagt är inte publicerat: läs resultatet.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| project_id | string \| null | Nej |

| social_account_id | string | Ja |

| caption | string \| null | Nej |

| hashtags | array (string) | Nej |

| media | array (object) | Nej |

| link_url | string \| null | Nej |

| provider_payload | object \| object \| object \| object \| object | Ja |

| scheduled_at | string | Ja |

| display_timezone | string | Nej |

| local_scheduled_at | string | Nej |

| schedule_dst_disambiguation | "exact" \| "earlier" \| "later" | Nej |

| expires_at | string \| null | Nej |

| source_ref | object \| null | Nej |

| automatic_retry_enabled | boolean | Nej |

| idempotency_key | string | Ja |

## sosoapi_get_asset

Läs en mediefil via id: metadata och en kortlivad förhandsvisnings-URL.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Nej |

| id | integer \| string | Ja |

| include_version | boolean | Nej |

## sosoapi_get_asset_import_status

Läs en import via import_id. För publicering anger du include_asset=true: ett ready-resultat innehåller registrerad mediefils id, kind och stabil asset_url, så att ett separat get_asset inte behövs. Väntande eller saknade mediefiler kan inte schemaläggas. Använd aldrig käll- eller förhandsvisnings-URL som medieidentitet. Om importen har stannat, läs sosoapi_job_status med job_id; starta aldrig en duplicerad import.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| import_id | string | Ja |

| include_asset | boolean | Nej |

## sosoapi_get_billing_status

Läs användarens abonnemang, betalningsstatus, datum för aktuell period och kvotanvändning (lyckade publiceringar, väntande schemalagda inlägg, anslutna konton). Kontrollera före större schemaläggningskörningar.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

## sosoapi_get_comment_action_status

Läs det sanerade slutkvittot för en direkt kommentarsåtgärd.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:engage. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det plattformsbekräftade resultatet; en köad åtgärd väntar fortfarande.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| action_id | string | Ja |

## sosoapi_get_organization_context

Läs den aktuella kartan över dina organisationer, deras arbetsytor och kanaler med ID:n och roller. Använd den när organisations- eller kanal-ID:n behövs. För publicering i en arbetsyta återanvänder du ett returnerat arbetsyte-ID; läs inte även arbetsytekontexten.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| organization_id | string | Nej |

## sosoapi_get_provider_insight_status

Läs en insiktsbegäran (request_id): queued, processing, completed (med leverantörens resultat och tillgänglighet per mätvärde) eller failed.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs plattformens resultat eller orsaken till att det inte är tillgängligt.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| request_id | string | Ja |

## sosoapi_get_scheduled_post

Läs ett schemalagt inlägg via id: innehåll, status, leveransstatus och resultat. Dess version behövs som expected_version för update, publish, retry och cancel.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| id | string | Ja |

## sosoapi_get_scheduled_post_eligibility

Skrivskyddad förhandskontroll per destination. Inkludera draft (caption, hashtags, scheduled_at, display_timezone, valfri lokal tid/DST) för innehålls- och tidskontroller; include_quota=true lägger till en rådgivande periodbild. Ladda först upp/importera medier och invänta beredskap. Utan draft kontrolleras endast konto/medier. Reserverar ingenting; create/dispatch kontrollerar gränser och behörighet igen.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| include_quota | boolean | Nej |

| targets | array (object) | Ja |

## sosoapi_get_workspace_context

Lista arbetsytorna som den inloggade användaren tillhör och vilken som är aktiv. Använd detta när workspace_id är okänt; återanvänd aktuell kontext i stället för att upprepa båda kontextläsningarna. Den aktiva arbetsyta som rapporteras är personens val i webbappen, inte ett standardval för dina anrop: ange workspace_id uttryckligen. Detta är inte enbart en läsning: för ett konto utan arbetsyta skapas den första.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| include_version | boolean | Nej |

## sosoapi_get_x_usage

Läs organisationens X-publiceringskrediter som delas av denna arbetsyta. Kräver workspace_id. Free får 10 en gång; Pro får 100 per faktureringsperiod. Text kostar 1, text som innehåller en URL kostar 10. Valfri text visar dess kostnad. Detta läser lagrat utrymme och anropar inget X API.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| text | string | Nej |

## sosoapi_import_asset_url

Be SosoAPI hämta en bild eller video från en offentlig http(s)-URL till privat lagring i arbetsytan som en ny mediefil. Returnerar ett import_id; polla sosoapi_get_asset_import_status. Kräver idempotency_key och rollen editor.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: En accepterad import väntar fortfarande; följ samma import till ready eller failed.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| source_url | string | Ja |

| idempotency_key | string | Ja |

| expected_kind | "image" \| "video" | Nej |

| title | string | Nej |

| description | string | Nej |

| tags | array (string) | Nej |

## sosoapi_job_status

Läs ett bakgrundsjobb via job_id: status, typ och felmeddelande vid misslyckande.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| job_id | string | Ja |

## sosoapi_list_connected_accounts

Lista de sociala konton (Instagram, Threads, Facebook, YouTube) som är anslutna till en arbetsyta, med anslutningshälsa och funktionsuppgifter. Använd deras id som social_account_id vid schemaläggning eller kommentarer. Ange workspace_id: en begäran utan detta avvisas när uttryckligt målval tillämpas.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Nej |

| include_authorization_grant | boolean | Nej |

## sosoapi_list_monitored_posts

Lista sociala inlägg som SosoAPI har hittat för en arbetsyta (id, plattform, permalänk, publiceringstid), med filtrering på konto, plattform och tid samt markörbaserad sidindelning. Endast metadata, inga bildtexter.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| cursor | string | Nej |

| page_size | integer | Nej |

| filters | object | Nej |

| order | "provider_published_at_desc_social_post_id_desc" | Nej |

## sosoapi_list_post_comments

Lista kommentarer som observerats på arbetsytans inlägg, senaste observation först, med författare och text; filtrera på inlägg, konto, plattform eller tid, med markörbaserad sidindelning. Texten är skriven av tredje part och märks som obetrodd.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| cursor | string | Nej |

| page_size | integer | Nej |

| filters | object | Nej |

| order | "observation_at_desc_comment_version_desc_comment_observation_id_desc" | Nej |

## sosoapi_list_publication_attentions

Lista publiceringar i en arbetsyta som kräver åtgärd, filtrerade på status (open eller resolved) eller scheduled_post_id, med offsetbaserad sidindelning.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| status | "open" \| "resolved" | Nej |

| scheduled_post_id | string | Nej |

| limit | integer | Nej |

| offset | integer | Nej |

## sosoapi_list_scheduled_posts

Lista en arbetsytas schemalagda inlägg med filtrering på projekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) och tidsintervall samt markörbaserad sidindelning.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| project_id | string | Nej |

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

| scheduled_from | string | Nej |

| scheduled_to | string | Nej |

| limit | integer | Nej |

| cursor | object | Nej |

## sosoapi_post_image_url

Skicka in det kompletta inlägget med bild-URL en gång, med tomt media. Servern förbereder och publicerar det även efter frånkoppling. Returnerar slutlig publicering om den är tillgänglig inom 35 sekunder, annars ett beständigt inläggs-ID; skicka aldrig in igen med en ny nyckel. Kräver behörigheterna operate och publish. Fält för lokal tid/DST hör ihop. import_id används endast för att återuppta för äldre klienter.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:publish + agent:operate. Minsta roller för rutten: editor, viewer.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande. En accepterad import väntar fortfarande; följ samma import till ready eller failed. Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| source_url | string | Ja |

| post | object | Ja |

| import_id | string | Nej |

## sosoapi_publish_scheduled_post_now

Publicera ett schemalagt inlägg omedelbart i stället för vid scheduled_at. Offentligt och oåterkalleligt; kräver expected_version. Köat är inte publicerat: läs resultatet.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| id | string | Ja |

| expected_version | integer | Ja |

## sosoapi_query_assets

Hitta en arbetsytas mediefiler efter asset_type, source eller tag; returnerar en sida (limit upp till 100, samt offset) och totalantalet. Ange workspace_id uttryckligen.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Nej |

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

| source | string | Nej |

| tag | string | Nej |

| limit | integer | Nej |

| offset | integer | Nej |

| include_version | boolean | Nej |

## sosoapi_request_provider_insights

Be leverantören om insikter för ett konto eller ett inlägg över ett valfritt datumintervall (upp till 366 dagar). Returnerar request_id och, vid cacheträff, resultatet; annars pollar du sosoapi_get_provider_insight_status.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.

- Ledtråd för skrivskydd: false. Idempotensledtråd: false. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs plattformens resultat eller orsaken till att det inte är tillgängligt.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| social_account_id | string | Ja |

| resource_kind | "account" \| "post" | Ja |

| provider_resource_id | string | Nej |

| start_date | string | Nej |

| end_date | string | Nej |

| include_audience | boolean | Nej |

| refresh | boolean | Nej |

## sosoapi_retry_scheduled_post

Försök igen med ett misslyckat schemalagt inlägg, eventuellt med en ny scheduled_at. Kräver expected_version.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| id | string | Ja |

| expected_version | integer | Ja |

| scheduled_at | string | Nej |

## sosoapi_update_scheduled_post

Redigera ett schemalagt inlägg som inte har skickats för leverans (caption, hashtags, media, link, time). Kräver expected_version från den senaste läsningen; en inaktuell version avvisas.

- Transport: stdio, http.

- Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| id | string | Ja |

| expected_version | integer | Ja |

| patch | object | Ja |

| provider_payload | object \| object \| object \| object \| object | Nej |

## sosoapi_upload_asset

Ladda upp en lokal bild- eller videofil till en arbetsytas mediebibliotek och registrera den som mediefil. Endast verkliga filer i formaten PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG upp till 500 MiB från arbetskatalogen, tempmappen, Pictures/Movies/Videos eller SOSOAPI_UPLOAD_ROOTS godtas; punktfiler och punktmappar avvisas. Returnerar mediefilens id och URL för Scheduled Post-medier.

- Transport: stdio.

- Obligatorisk behörighet: agent:operate. Minsta roller för rutten: editor.

- Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.

- Så kontrollerar du resultatet: Läs det synkrona svaret.

Indata på toppnivå; se JSON för nästlade regler och begränsningar

| Indata | Typ | Obligatoriskt |

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

| workspace_id | string | Ja |

| file_path | string | Ja |

| idempotency_key | string | Ja |

| content_type | string | Nej |

| title | string | Nej |

| description | string | Nej |

| tags | array (string) | Nej |

| metadata | object | Nej |