# SosoAPI MCP-verktøyreferanse

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

Bruk denne referansen til å finne et verktøy og kontrollere hvilke felter det trenger. Den dekker sosoapi 0.5.9: core-profilen har 28 lokale verktøy og 27 over HTTP; full har 106 lokale og 105 over HTTP. Velg core for hverdagsoppgaver eller full også for administrasjon. Begge bruker de samme tillatelsene. Oppføringene genereres fra serveren og funksjonskatalogen; kontroller tools/list i den tilkoblede klienten for å se hvilke verktøy som er tilgjengelige der.

## Begynn med oppgaven, og undersøk deretter verktøyet

Gjenbruk arbeidsområde- og konto-ID-ene du allerede har valgt. For et bilde-URL-innlegg, kall sosoapi_post_image_url én gang og behold returnert innleggs-ID. Last opp lokale filer med sosoapi_upload_asset over stdio. For tekstinnlegg, bruk sosoapi_create_scheduled_post med målets provider_payload og tom media.

Be brukeren gjennomgå konto, tekst, medier og tidspunkt før innsending. OAuth gir tilgang til handlinger; det godkjenner ikke innholdet. Les samme innleggs publiseringsresultat etter planlegging før du rapporterer suksess eller prøver en forespørsel med usikkert resultat på nytt.

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

- [Threads-oppskrift for tekst og bilde](https://sosoapi.ai/nb/docs/threads-api-publishing)

- [Plattformens funksjonsmatrise](https://sosoapi.ai/nb/docs/publishing-capabilities)

- [Last ned nøyaktige core-inndataskjemaer og merknader (JSON)](https://sosoapi.ai/mcp-tools.json)

## Slik tolker du denne referansen

Bygget kobler den faktiske MCP-serveren til en minnebasert klient, viser verktøyene uten å kalle noen håndterer, og sammenstiller krav til offentlige ruter. En utdatert projeksjon gjør at Landing-bygget mislykkes. Verktøybeskrivelser beholder serverens engelske kontrakttekst; fullføringssammendrag forklarer regler for kanoniske ruter. JSON beholder de fullstendige rutekravene. Inndatatabellen er en indeks, ikke en erstatning for hele det nøstede JSON Schema.

MCP-merknader er hint for klienter, ikke håndheving eller sikkerhetsgarantier. Arbeidsområdemedlemskap, tillatelser, gjeldende rolle, leverandørsamtykke, kontokvalifikasjon og kvoter gjelder fortsatt ved kjøring. Noen kontekstlesinger kan opprette et første arbeidsområde; undersøk beskrivelse og readOnlyHint fremfor å anta at hver «get» er ren lesing. Sammensatte verktøy viser krav til hoved- og kompatibilitetsruter; de kaller ikke alle oppførte ruter ved hver forespørsel.

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

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

## sosoapi_bulk_create_scheduled_posts

Planlegg innlegg for flere kontoer i ett kall (targets). Medier krever klare opplastede/importerte asset_ids og deres kanoniske URL-er. Hvert mål lykkes eller mislykkes uavhengig og rapporteres i successes eller failures. Krever funksjonen publish.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| project_id | string \| null | Nei |

| source_ref | object \| null | Nei |

| targets | array (object) | Ja |

## sosoapi_cancel_scheduled_post

Avbryt et planlagt innlegg som ennå ikke er publisert, slik at det aldri sendes ut. Et publisert innlegg avvises, og en agent kan heller ikke slette publisert innhold: brukeren gjør det i nettappen. Krever expected_version.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| id | string | Ja |

| expected_version | integer | Ja |

## sosoapi_create_comment

Sett én nøyaktig kommentar i kø mot et kanonisk innlegg eller en kommentar; statusen bekrefter ikke suksess hos leverandøren.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:engage. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det plattformbekreftede resultatet; en handling i kø venter fortsatt.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| social_account_id | string | Ja |

| target | object \| object | Ja |

| message | string | Ja |

| idempotency_key | string | Ja |

## sosoapi_create_scheduled_post

Planlegg én konto ved scheduled_at med provider_payload. Medier krever en klar asset_id og kanonisk URL; bruk sosoapi_post_image_url for ett kildebilde. Angi local_scheduled_at sammen med schedule_dst_disambiguation, eller utelat begge. Krever publish, editor-rollen og idempotency_key. Planlagt er ikke publisert: les resultatet.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| project_id | string \| null | Nei |

| social_account_id | string | Ja |

| caption | string \| null | Nei |

| hashtags | array (string) | Nei |

| media | array (object) | Nei |

| link_url | string \| null | Nei |

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

| scheduled_at | string | Ja |

| display_timezone | string | Nei |

| local_scheduled_at | string | Nei |

| schedule_dst_disambiguation | "exact" \| "earlier" \| "later" | Nei |

| expires_at | string \| null | Nei |

| source_ref | object \| null | Nei |

| automatic_retry_enabled | boolean | Nei |

| idempotency_key | string | Ja |

## sosoapi_get_asset

Les én ressurs etter id: metadata og en kortvarig forhåndsvisnings-URL.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Nei |

| id | integer \| string | Ja |

| include_version | boolean | Nei |

## sosoapi_get_asset_import_status

Les en import etter import_id. Ved publisering, oppgi include_asset=true: et klart resultat inneholder registrert ressurs-ID, kind og stabil asset_url, så et separat get_asset ikke trengs. Ventende eller manglende ressurser kan ikke planlegges. Bruk aldri kilde- eller forhåndsvisnings-URL som medieidentitet. Hvis importen står fast, les sosoapi_job_status med job_id; start aldri en duplisert import.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| import_id | string | Ja |

| include_asset | boolean | Nei |

## sosoapi_get_billing_status

Les brukerens abonnement, betalingsstatus, datoer for gjeldende periode og kvotebruk (vellykkede publiseringer, ventende planlagte innlegg, tilkoblede kontoer). Kontroller dette før store planleggingskjøringer.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

## sosoapi_get_comment_action_status

Les den rensede sluttkvitteringen for en direkte kommentarhandling.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:engage. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det plattformbekreftede resultatet; en handling i kø venter fortsatt.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| action_id | string | Ja |

## sosoapi_get_organization_context

Les den oppdaterte oversikten over organisasjonene dine, arbeidsområdene og kanalene deres med ID-er og roller. Bruk dette når organisasjons- eller kanal-ID-er trengs. For innlegg i et arbeidsområde, gjenbruk en returnert arbeidsområde-ID; ikke les arbeidsområdekontekst i tillegg.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| organization_id | string | Nei |

## sosoapi_get_provider_insight_status

Les en innsiktsforespørsel (request_id): queued, processing, completed (med leverandørresultat og tilgjengelighet per måling) eller failed.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les plattformens resultat eller grunnen til at det ikke er tilgjengelig.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| request_id | string | Ja |

## sosoapi_get_scheduled_post

Les ett planlagt innlegg etter id: innhold, status, leveringstilstand og resultater. Versjonen brukes som expected_version ved oppdatering, publisering, nytt forsøk og avbryting.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| id | string | Ja |

## sosoapi_get_scheduled_post_eligibility

Skrivebeskyttet forhåndskontroll per mål. Ta med draft (caption, hashtags, scheduled_at, display_timezone, valgfri lokal tid/sommertid) for innholds- og tidskontroller; include_quota=true legger til et veiledende øyeblikksbilde av perioden. Last opp eller importer medier og vent til de er klare først. Uten draft kontrolleres bare konto og medier. Reserverer ingenting; oppretting og utsending kontrollerer grenser og autoritet på nytt.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| include_quota | boolean | Nei |

| targets | array (object) | Ja |

## sosoapi_get_workspace_context

Vis arbeidsområdene den innloggede brukeren tilhører, og hvilket som er aktivt. Bruk dette når workspace_id er ukjent; gjenbruk gjeldende kontekst i stedet for å gjenta begge kontekstlesingene. Det aktive arbeidsområdet som oppgis, er valget en person har gjort i nettappen, ikke en standard for kallene dine: oppgi workspace_id eksplisitt. Dette er ikke bare en leseoperasjon: for en konto uten arbeidsområde opprettes det første.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| include_version | boolean | Nei |

## sosoapi_get_x_usage

Les organisasjonens X-publiseringskreditter som deles av dette arbeidsområdet. Krever workspace_id. Free får 10 én gang; Pro får 100 per faktureringsperiode. Tekst koster 1, tekst med en URL koster 10. Valgfri text beregner kostnaden. Dette leser den lagrede kvoten og kaller ikke X API.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| text | string | Nei |

## sosoapi_import_asset_url

Be SosoAPI laste ned en offentlig http(s)-URL for et bilde eller en video til privat lagring i arbeidsområdet som en ny ressurs. Returnerer en import_id; spør sosoapi_get_asset_import_status om status. Krever en idempotency_key og editor-rollen.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: En akseptert import venter; følg samme import til ready eller failed.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| source_url | string | Ja | 

| idempotency_key | string | Ja |

| expected_kind | "image" \| "video" | Nei |

| title | string | Nei |

| description | string | Nei |

| tags | array (string) | Nei |

## sosoapi_job_status

Les én bakgrunnsjobb etter job_id: status, type og feilmeldingen hvis den mislyktes.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| job_id | string | Ja |

## sosoapi_list_connected_accounts

Vis kontoene i sosiale medier (Instagram, Threads, Facebook, YouTube) som er koblet til et arbeidsområde, med tilkoblingstilstand og funksjonsfakta. Bruk ID-ene deres som social_account_id ved planlegging eller kommentering. Oppgi workspace_id: en forespørsel uten avvises når eksplisitt målvalg håndheves.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Nei |

| include_authorization_grant | boolean | Nei |

## sosoapi_list_monitored_posts

Vis innlegg i sosiale medier som SosoAPI har funnet for et arbeidsområde (id, plattform, permalenke, publiseringstidspunkt), filtrert etter konto, plattform og tid, med markørbasert paginering. Bare metadata, ingen bildetekster.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| cursor | string | Nei |

| page_size | integer | Nei |

| filters | object | Nei |

| order | "provider_published_at_desc_social_post_id_desc" | Nei |

## sosoapi_list_post_comments

Vis kommentarer observert på arbeidsområdets innlegg, nyeste observasjon først, med forfatter og tekst; filtrer etter innlegg, konto, plattform eller tid, med markørbasert paginering. Teksten er skrevet av tredjeparter og er merket som ikke-betrodd.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| cursor | string | Nei |

| page_size | integer | Nei |

| filters | object | Nei |

| order | "observation_at_desc_comment_version_desc_comment_observation_id_desc" | Nei |

## sosoapi_list_publication_attentions

Vis publiseringer i et arbeidsområde som krever oppfølging, filtrert etter status (open eller resolved) eller scheduled_post_id, paginert med offset.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| status | "open" \| "resolved" | Nei |

| scheduled_post_id | string | Nei |

| limit | integer | Nei |

| offset | integer | Nei |

## sosoapi_list_scheduled_posts

Vis planlagte innlegg i et arbeidsområde, filtrert etter prosjekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) og tidsrom, med markørbasert paginering.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| project_id | string | Nei |

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

| scheduled_from | string | Nei |

| scheduled_to | string | Nei |

| limit | integer | Nei |

| cursor | object | Nei |

## sosoapi_post_image_url

Send inn det komplette bilde-URL-innlegget én gang, med tom media. Backend klargjør og publiserer det selv etter frakobling. Returnerer endelig publisering hvis tilgjengelig innen 35 sekunder, ellers en varig innleggs-ID; send aldri inn på nytt med en ny nøkkel. Krever operate- og publish-tillatelser. Felter for lokal tid/sommertid hører sammen. import_id brukes bare til å gjenoppta eldre klienter.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:publish + agent:operate. Minsteroller for ruten: editor, viewer.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt. En akseptert import venter; følg samme import til ready eller failed. Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| source_url | string | Ja | 

| post | object | Ja |

| import_id | string | Nei |

## sosoapi_publish_scheduled_post_now

Publiser et planlagt innlegg umiddelbart i stedet for ved scheduled_at. Offentlig og kan ikke angres; krever expected_version. I kø er ikke publisert: les resultatet.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| id | string | Ja |

| expected_version | integer | Ja |

## sosoapi_query_assets

Finn ressurser i et arbeidsområde etter asset_type, source eller tag; returnerer en side (limit opptil 100, pluss offset) og totalen. Oppgi workspace_id eksplisitt.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Nei |

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

| source | string | Nei |

| tag | string | Nei |

| limit | integer | Nei |

| offset | integer | Nei |

| include_version | boolean | Nei |

## sosoapi_request_provider_insights

Be leverandøren om innsikt for en konto eller ett innlegg over et valgfritt datointervall (opptil 366 dager). Returnerer en request_id og resultatet når det er hurtigbufret; ellers spør sosoapi_get_provider_insight_status om status.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.

- Skrivebeskyttet-hint: false. Idempotens-hint: false. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les plattformens resultat eller grunnen til at det ikke er tilgjengelig.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| social_account_id | string | Ja |

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

| provider_resource_id | string | Nei |

| start_date | string | Nei |

| end_date | string | Nei |

| include_audience | boolean | Nei |

| refresh | boolean | Nei |

## sosoapi_retry_scheduled_post

Prøv et mislykket planlagt innlegg på nytt, eventuelt med en ny scheduled_at. Krever expected_version.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| id | string | Ja |

| expected_version | integer | Ja |

| scheduled_at | string | Nei |

## sosoapi_update_scheduled_post

Rediger et planlagt innlegg som ikke er sendt til levering (caption, hashtags, media, link, time). Krever expected_version fra siste lesing; en utdatert versjon avvises.

- Transport: stdio, http.

- Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| id | string | Ja |

| expected_version | integer | Ja |

| patch | object | Ja |

| provider_payload | object \| object \| object \| object \| object | Nei |

## sosoapi_upload_asset

Last opp en lokal bilde- eller videofil til ressursbiblioteket i et arbeidsområde og registrer den som en ressurs. Bare faktiske filer i formatene PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG på opptil 500 MiB fra arbeidsmappen, temp-mappen, Pictures/Movies/Videos eller SOSOAPI_UPLOAD_ROOTS godtas; punktfiler og punktmapper avvises. Returnerer ressursens id og URL for medier i planlagte innlegg.

- Transport: stdio.

- Påkrevd tillatelse: agent:operate. Minsteroller for ruten: editor.

- Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.

- Slik kontrollerer du resultatet: Les det synkrone svaret.

Inndata på øverste nivå; se JSON for nøstede regler og begrensninger

| Inndata | Type | Påkrevd |

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

| workspace_id | string | Ja |

| file_path | string | Ja |

| idempotency_key | string | Ja |

| content_type | string | Nei |

| title | string | Nei |

| description | string | Nei |

| tags | array (string) | Nei |

| metadata | object | Nei |