Planlegging og publisering

Opprett ordnet X-tråd

Planlegg en ordnet X-tråd atomisk; hvert element reserverer sin egen gjeldende Post-kredittkostnad. Ingen gebyrer for overforbruk.

POST /studio-api/x-post-threads/create

Kontrakt gjennomgått: 2026-10-23 · sha256:304f090f3c014931

Les som Markdown Last ned offentlig kontrakt Last ned OpenAPI

Oversikt

Planlegg en ordnet X-tråd atomisk; hvert element reserverer sin egen gjeldende Post-kredittkostnad. Ingen gebyrer for overforbruk.

Et vellykket HTTP-svar kan bety at en forespørsel er akseptert fremfor fullført. For bakgrunnsarbeid, lagre returnert ID og kontroller samme operasjon til den er ferdig. Et planlagt eller akseptert innlegg er først publisert når plattformen bekrefter det; et klienttidsavbrudd fastslår ikke resultatet.

Autentisering og tillatelser

Godtatte legitimasjonsklasser: user_session, delegated_oauth, personal_access_token
Delegert funksjon: agent:publish
Minste arbeidsområderolle: editor
Tilgangsomfang: Ressurser denne brukeren er autorisert til å bruke
Samtykke for alle arbeidsområder kreves: Nei
Endrer tilstand: Ja
Når operasjonen er fullført: canonical per-Post terminal publication outcomes; thread acceptance is not publication

Et token kan bare bruke rettighetene eieren har. Hver forespørsel kontrollerer arbeidsområdemedlemskap, ressurseierskap, valgte arbeidsområder og gitte funksjoner. Profilene core og full endrer hvilke verktøy som vises; de gir ikke tilgang.

Forespørselsfelter

Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.

Forespørselsfelter
Felt / gren	Type / påkrevd	Begrensninger
`$`	`object`Påkrevd i forelder	`additionalProperties: false`
`version`	`number`Påkrevd i forelder	`const: 1`
`workspace_id`	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`social_account_id`	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`scheduled_at`	`string`Påkrevd i forelder	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`display_timezone`	`string`Valgfritt / element	`minLength: 1` `maxLength: 80` `default: "UTC"`
`idempotency_key`	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 128`
`project_id`	`string \| null`Valgfritt / element	—
`project_id`anyOf 1	`string`Valgfritt / element	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`project_id`anyOf 2	`null`Valgfritt / element	—
`items`	`array`Påkrevd i forelder	`minItems: 2` `maxItems: 25`
`items[]`	`object`Valgfritt / element	`additionalProperties: false`
`items[].item_id`	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`items[].caption`	`string \| null`Valgfritt / element	`default: null`
`items[].caption`anyOf 1	`string`Valgfritt / element	`maxLength: 5000`
`items[].caption`anyOf 2	`null`Valgfritt / element	—
`items[].hashtags`	`array`Valgfritt / element	`maxItems: 100` `default: []`
`items[].hashtags[]`	`string`Valgfritt / element	`maxLength: 100`
`items[].media`	`array`Valgfritt / element	`maxItems: 20` `default: []`
`items[].media[]`	`object`Valgfritt / element	`additionalProperties: false`
`items[].media[].kind`	`string`Påkrevd i forelder	`enum: ["image","video"]`
`items[].media[].url`	`string`Påkrevd i forelder	`format: "uri"`
`items[].media[].cover_url`	`string \| null`Valgfritt / element	—
`items[].media[].cover_url`anyOf 1	`string`Valgfritt / element	`format: "uri"`
`items[].media[].cover_url`anyOf 2	`null`Valgfritt / element	—
`items[].media[].cover_asset_id`	`integer \| null`Valgfritt / element	—
`items[].media[].cover_asset_id`anyOf 1	`integer`Valgfritt / element	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`items[].media[].cover_asset_id`anyOf 2	`null`Valgfritt / element	—
`items[].media[].asset_id`	`integer \| null`Valgfritt / element	—
`items[].media[].asset_id`anyOf 1	`integer`Valgfritt / element	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`items[].media[].asset_id`anyOf 2	`null`Valgfritt / element	—
`items[].media[].mime_type`	`string \| null`Valgfritt / element	—
`items[].media[].mime_type`anyOf 1	`string`Valgfritt / element	`minLength: 1` `maxLength: 160`
`items[].media[].mime_type`anyOf 2	`null`Valgfritt / element	—
`items[].link_url`	`string \| null`Valgfritt / element	—
`items[].link_url`anyOf 1	`string`Valgfritt / element	`format: "uri"`
`items[].link_url`anyOf 2	`null`Valgfritt / element	—
`items[].publish_options`	`object`Påkrevd i forelder	`additionalProperties: false`
`items[].publish_options.post_type`	`string`Påkrevd i forelder	`enum: ["TEXT","VIDEO","IMAGE"]`

Fullstendig JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "version": {
      "type": "number",
      "const": 1
    },
    "workspace_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "social_account_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "scheduled_at": {
      "type": "string",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "format": "date-time"
    },
    "display_timezone": {
      "default": "UTC",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "project_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "items": {
      "minItems": 2,
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "item_id": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
          },
          "caption": {
            "default": null,
            "anyOf": [
              {
                "type": "string",
                "maxLength": 5000
              },
              {
                "type": "null"
              }
            ]
          },
          "hashtags": {
            "default": [],
            "maxItems": 100,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 100
            }
          },
          "media": {
            "default": [],
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "image",
                    "video"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "cover_url": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "uri"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "cover_asset_id": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "asset_id": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "mime_type": {
                  "anyOf": [
                    {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 160
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "kind",
                "url"
              ],
              "additionalProperties": false
            }
          },
          "link_url": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "publish_options": {
            "type": "object",
            "properties": {
              "post_type": {
                "type": "string",
                "enum": [
                  "TEXT",
                  "VIDEO",
                  "IMAGE"
                ]
              }
            },
            "required": [
              "post_type"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "item_id",
          "publish_options"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "version",
    "workspace_id",
    "social_account_id",
    "scheduled_at",
    "idempotency_key",
    "items"
  ],
  "additionalProperties": false
}

Svar og fullføring

HTTP-statuser ved suksess: 200, 201. Når operasjonen er fullført: canonical per-Post terminal publication outcomes; thread acceptance is not publication.

Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.

Svar og fullføring
Felt / gren	Type / påkrevd	Begrensninger
`$`	`object`Påkrevd i forelder	—
`thread`	`object`Påkrevd i forelder	—
`thread.id`	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.workspace_id`	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.social_account_id`	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.idempotency_key`	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 128`
`thread.item_count`	`integer`Påkrevd i forelder	`minimum: 2` `maximum: 25`
`thread.created_at`	`string`Påkrevd i forelder	—
`thread.items`	`array`Påkrevd i forelder	`minItems: 2` `maxItems: 25`
`thread.items[]`	`object`Valgfritt / element	—
`thread.items[].item_id`	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.items[].ordinal`	`integer`Påkrevd i forelder	`minimum: 1` `maximum: 25`
`thread.items[].predecessor_post_id`	`string \| null`Påkrevd i forelder	—
`thread.items[].predecessor_post_id`anyOf 1	`string`Påkrevd i forelder	`pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"`
`thread.items[].predecessor_post_id`anyOf 2	`null`Påkrevd i forelder	—
`thread.items[].post`	`object`Påkrevd i forelder	—
`thread.items[].post.id`	`string`Påkrevd i forelder	`pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"`
`thread.items[].post.workspace_id`	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.items[].post.social_account_id`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.social_account_id`anyOf 1	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.items[].post.social_account_id`anyOf 2	`null`Påkrevd i forelder	—
`thread.items[].post.platform`	`string`Påkrevd i forelder	`enum: ["instagram","threads","facebook","youtube","x"]`
`thread.items[].post.destination`	`object`Påkrevd i forelder	—
`thread.items[].post.destination.social_account_id`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.destination.social_account_id`anyOf 1	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.items[].post.destination.social_account_id`anyOf 2	`null`Påkrevd i forelder	—
`thread.items[].post.destination.platform`	`string`Påkrevd i forelder	`enum: ["instagram","threads","facebook","youtube","x"]`
`thread.items[].post.destination.platform_user_id`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.destination.account_label`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.caption`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.hashtags`	`array`Påkrevd i forelder	—
`thread.items[].post.hashtags[]`	`string`Valgfritt / element	—
`thread.items[].post.media`	`array`Påkrevd i forelder	—
`thread.items[].post.media[]`	`object`Valgfritt / element	—
`thread.items[].post.media[].kind`	`string`Påkrevd i forelder	`enum: ["image","video"]`
`thread.items[].post.media[].url`	`string`Påkrevd i forelder	`format: "uri"`
`thread.items[].post.media[].cover_url`	`string \| null`Valgfritt / element	—
`thread.items[].post.media[].cover_url`anyOf 1	`string`Valgfritt / element	`format: "uri"`
`thread.items[].post.media[].cover_url`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.media[].cover_asset_id`	`integer \| null`Valgfritt / element	—
`thread.items[].post.media[].cover_asset_id`anyOf 1	`integer`Valgfritt / element	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`thread.items[].post.media[].cover_asset_id`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.media[].asset_id`	`integer \| null`Valgfritt / element	—
`thread.items[].post.media[].asset_id`anyOf 1	`integer`Valgfritt / element	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`thread.items[].post.media[].asset_id`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.media[].mime_type`	`string \| null`Valgfritt / element	—
`thread.items[].post.media[].mime_type`anyOf 1	`string`Valgfritt / element	`minLength: 1` `maxLength: 160`
`thread.items[].post.media[].mime_type`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.media[].preview_url`	`string \| null`Valgfritt / element	Midlertidig autorisert lese-URL; behold url som varig medieidentitet for planlagt innlegg. —
`thread.items[].post.media[].preview_url`anyOf 1	`string`Valgfritt / element	`format: "uri"`
`thread.items[].post.media[].preview_url`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.media[].cover_preview_url`	`string \| null`Valgfritt / element	Midlertidig autorisert lese-URL for forsidebilde; behold cover_url som varig medieidentitet. —
`thread.items[].post.media[].cover_preview_url`anyOf 1	`string`Valgfritt / element	`format: "uri"`
`thread.items[].post.media[].cover_preview_url`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.media[].preview_expires_at`	`string \| null`Valgfritt / element	—
`thread.items[].post.media[].preview_expires_at`anyOf 1	`string`Valgfritt / element	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"`
`thread.items[].post.media[].preview_expires_at`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.link_url`	`string \| null`Valgfritt / element	—
`thread.items[].post.link_url`anyOf 1	`string`Valgfritt / element	`format: "uri"`
`thread.items[].post.link_url`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.publish_options`	`object`Påkrevd i forelder	—
`thread.items[].post.publish_options.post_type`	`string`Valgfritt / element	`enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]`
`thread.items[].post.publish_options.location_id`	`string`Valgfritt / element	`minLength: 1`
`thread.items[].post.publish_options.share_to_feed`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.collaborators`	`array`Valgfritt / element	`maxItems: 3`
`thread.items[].post.publish_options.collaborators[]`	`string`Valgfritt / element	`minLength: 1`
`thread.items[].post.publish_options.first_comment`	`string`Valgfritt / element	`minLength: 1` `maxLength: 2200`
`thread.items[].post.publish_options.topic_tag`	`string`Valgfritt / element	`minLength: 1`
`thread.items[].post.publish_options.thumb_offset_ms`	`integer`Valgfritt / element	`minimum: 0` `maximum: 9007199254740991`
`thread.items[].post.publish_options.title`	`string`Valgfritt / element	`maxLength: 255`
`thread.items[].post.publish_options.youtube_privacy_status`	`string`Valgfritt / element	`enum: ["private","unlisted","public"]`
`thread.items[].post.publish_options.youtube_category_id`	`string`Valgfritt / element	`pattern: "^\\d+$"`
`thread.items[].post.publish_options.youtube_contains_synthetic_media`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.description`	`string`Valgfritt / element	`maxLength: 5000`
`thread.items[].post.publish_options.category_id`	`string`Valgfritt / element	`pattern: "^\\d+$"`
`thread.items[].post.publish_options.privacy_status`	`string`Valgfritt / element	`enum: ["private","unlisted","public"]`
`thread.items[].post.publish_options.cancellation_mode`	`string`Valgfritt / element	`enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]`
`thread.items[].post.publish_options.tags`	`array`Valgfritt / element	—
`thread.items[].post.publish_options.tags[]`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.default_language`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.localizations`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.localizations.*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.license`	`string`Valgfritt / element	`enum: ["youtube","creativeCommon"]`
`thread.items[].post.publish_options.embeddable`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.public_stats_viewable`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.self_declared_made_for_kids`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.contains_synthetic_media`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.has_paid_product_placement`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.recording_date`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.notify_subscribers`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.thumbnail_asset_id`	`integer`Valgfritt / element	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`thread.items[].post.publish_options.surface_expectation`	`string`Valgfritt / element	`const: "SHORT"`
`thread.items[].post.publish_options.brand_partner`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.brand_partner.*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.cover_asset_id`	`integer`Valgfritt / element	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`thread.items[].post.publish_options.audio_name`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.trial_params`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.trial_params.*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.is_ai_generated`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.branded_content_sponsor_ids`	`array`Valgfritt / element	—
`thread.items[].post.publish_options.branded_content_sponsor_ids[]`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.is_paid_partnership`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.media_options`	`array`Valgfritt / element	—
`thread.items[].post.publish_options.media_options[]`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.media_options[].*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.reply_to_id`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.quote_post_id`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.repost_target_id`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.reply_control`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.enable_reply_approvals`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.link_attachment`	`string`Valgfritt / element	`format: "uri"`
`thread.items[].post.publish_options.poll_attachment`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.poll_attachment.*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.gif_attachment`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.gif_attachment.*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.text_attachment`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.text_attachment.*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.text_entities`	`array`Valgfritt / element	—
`thread.items[].post.publish_options.text_entities[]`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.text_entities[].*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.is_spoiler_media`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.is_ghost_post`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.allowlisted_country_codes`	`array`Valgfritt / element	—
`thread.items[].post.publish_options.allowlisted_country_codes[]`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.crossreshare_to_ig`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.crossreshare_to_ig_dark_mode`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.auto_publish_text`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.publication_mode`	`string`Valgfritt / element	`enum: ["PUBLISH","DRAFT"]`
`thread.items[].post.publish_options.backdated_time`	`number`Valgfritt / element	—
`thread.items[].post.publish_options.backdated_time_granularity`	`string`Valgfritt / element	`enum: ["year","month","day","hour","minute"]`
`thread.items[].post.publish_options.place`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.feed_targeting`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.feed_targeting.*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.targeting`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.targeting.*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.child_attachments`	`array`Valgfritt / element	—
`thread.items[].post.publish_options.child_attachments[]`	`object`Valgfritt / element	`additionalProperties: {}`
`thread.items[].post.publish_options.child_attachments[].*`	`any JSON value`Valgfritt / element	—
`thread.items[].post.publish_options.multi_share_end_card`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.multi_share_optimized`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.unpublished_content_type`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.no_story`	`boolean`Valgfritt / element	—
`thread.items[].post.publish_options.crossposted_video_id`	`string`Valgfritt / element	—
`thread.items[].post.publish_options.spherical`	`boolean`Valgfritt / element	—
`thread.items[].post.scheduled_at`	`string`Påkrevd i forelder	—
`thread.items[].post.display_timezone`	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 80`
`thread.items[].post.local_scheduled_at`	`string \| null`Valgfritt / element	—
`thread.items[].post.local_scheduled_at`anyOf 1	`string`Valgfritt / element	`pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"`
`thread.items[].post.local_scheduled_at`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.schedule_timezone`	`string \| null`Valgfritt / element	—
`thread.items[].post.schedule_timezone`anyOf 1	`string`Valgfritt / element	`minLength: 1` `maxLength: 80`
`thread.items[].post.schedule_timezone`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.schedule_dst_disambiguation`	`string \| null`Valgfritt / element	—
`thread.items[].post.schedule_dst_disambiguation`anyOf 1	`string`Valgfritt / element	`enum: ["exact","earlier","later"]`
`thread.items[].post.schedule_dst_disambiguation`anyOf 2	`null`Valgfritt / element	—
`thread.items[].post.schedule_intent_state`	`string`Valgfritt / element	`enum: ["verified","legacy_unverified"]`
`thread.items[].post.expires_at`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.status`	`string`Påkrevd i forelder	`enum: ["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]`
`thread.items[].post.version`	`integer`Påkrevd i forelder	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`thread.items[].post.automatic_retry_enabled`	`boolean`Påkrevd i forelder	—
`thread.items[].post.delete_requested_at`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.published_at`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.deleted_at`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.provider_post_id`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.permalink`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.permalink`anyOf 1	`string`Påkrevd i forelder	`format: "uri"`
`thread.items[].post.permalink`anyOf 2	`null`Påkrevd i forelder	—
`thread.items[].post.created_at`	`string`Påkrevd i forelder	—
`thread.items[].post.updated_at`	`string`Påkrevd i forelder	—
`thread.items[].post.project_id`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.project_id`anyOf 1	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.items[].post.project_id`anyOf 2	`null`Påkrevd i forelder	—
`thread.items[].post.batch_id`	`string \| null`Påkrevd i forelder	—
`thread.items[].post.batch_id`anyOf 1	`string`Påkrevd i forelder	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`thread.items[].post.batch_id`anyOf 2	`null`Påkrevd i forelder	—
`thread.items[].post.source_ref`	`object \| null`Påkrevd i forelder	—
`thread.items[].post.source_ref`anyOf 1	`object`Påkrevd i forelder	`additionalProperties: {}`
`thread.items[].post.source_ref.*`anyOf 1	`any JSON value`Valgfritt / element	—
`thread.items[].post.source_ref`anyOf 2	`null`Påkrevd i forelder	—
`thread.items[].retry_allowed`	`boolean`Påkrevd i forelder	—
`thread.expected_versions`	`object`Påkrevd i forelder	`additionalProperties: {"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}`
`thread.expected_versions.*`	`integer`Valgfritt / element	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`thread.actions`	`array`Påkrevd i forelder	`minItems: 2` `maxItems: 2`
`thread.actions[]`	`object`Valgfritt / element	—
`thread.actions[].action`	`string`Påkrevd i forelder	`enum: ["resume","cancel"]`
`thread.actions[].allowed`	`boolean`Påkrevd i forelder	—
`thread.actions[].reason_code`	`string`Påkrevd i forelder	`enum: ["allowed","no_failed_items","resolution_required","retry_unavailable","terminal_state"]`
`thread.actions[].message`	`string`Påkrevd i forelder	—
`deduped`	`boolean`Valgfritt / element	—

Fullstendig JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "thread": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "social_account_id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "idempotency_key": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "item_count": {
          "type": "integer",
          "minimum": 2,
          "maximum": 25
        },
        "created_at": {
          "type": "string"
        },
        "items": {
          "minItems": 2,
          "maxItems": 25,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "item_id": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
              },
              "ordinal": {
                "type": "integer",
                "minimum": 1,
                "maximum": 25
              },
              "predecessor_post_id": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "post": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
                  },
                  "workspace_id": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                  },
                  "social_account_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "instagram",
                      "threads",
                      "facebook",
                      "youtube",
                      "x"
                    ]
                  },
                  "destination": {
                    "type": "object",
                    "properties": {
                      "social_account_id": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "platform": {
                        "type": "string",
                        "enum": [
                          "instagram",
                          "threads",
                          "facebook",
                          "youtube",
                          "x"
                        ]
                      },
                      "platform_user_id": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "account_label": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "social_account_id",
                      "platform",
                      "platform_user_id",
                      "account_label"
                    ]
                  },
                  "caption": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "hashtags": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "media": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "image",
                            "video"
                          ]
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "cover_url": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uri"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "cover_asset_id": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "asset_id": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "mime_type": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 160
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "preview_url": {
                          "description": "Temporary authorized read URL; keep url as persisted Scheduled Post media identity.",
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uri"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "cover_preview_url": {
                          "description": "Temporary authorized cover read URL; keep cover_url as persisted media identity.",
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uri"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "preview_expires_at": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "url"
                      ]
                    }
                  },
                  "link_url": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "enum": [
                          "TEXT",
                          "LINK",
                          "IMAGE",
                          "MULTI_IMAGE",
                          "VIDEO",
                          "CAROUSEL",
                          "REELS",
                          "STORY_IMAGE",
                          "STORY_VIDEO",
                          "REPOST",
                          "SHORT"
                        ]
                      },
                      "location_id": {
                        "type": "string",
                        "minLength": 1
                      },
                      "share_to_feed": {
                        "type": "boolean"
                      },
                      "collaborators": {
                        "maxItems": 3,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "first_comment": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2200
                      },
                      "topic_tag": {
                        "type": "string",
                        "minLength": 1
                      },
                      "thumb_offset_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "title": {
                        "type": "string",
                        "maxLength": 255
                      },
                      "youtube_privacy_status": {
                        "type": "string",
                        "enum": [
                          "private",
                          "unlisted",
                          "public"
                        ]
                      },
                      "youtube_category_id": {
                        "type": "string",
                        "pattern": "^\\d+$"
                      },
                      "youtube_contains_synthetic_media": {
                        "type": "boolean"
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 5000
                      },
                      "category_id": {
                        "type": "string",
                        "pattern": "^\\d+$"
                      },
                      "privacy_status": {
                        "type": "string",
                        "enum": [
                          "private",
                          "unlisted",
                          "public"
                        ]
                      },
                      "cancellation_mode": {
                        "type": "string",
                        "enum": [
                          "DELETE",
                          "UNSCHEDULE_KEEP_PRIVATE"
                        ]
                      },
                      "tags": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "default_language": {
                        "type": "string"
                      },
                      "localizations": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      "license": {
                        "type": "string",
                        "enum": [
                          "youtube",
                          "creativeCommon"
                        ]
                      },
                      "embeddable": {
                        "type": "boolean"
                      },
                      "public_stats_viewable": {
                        "type": "boolean"
                      },
                      "self_declared_made_for_kids": {
                        "type": "boolean"
                      },
                      "contains_synthetic_media": {
                        "type": "boolean"
                      },
                      "has_paid_product_placement": {
                        "type": "boolean"
                      },
                      "recording_date": {
                        "type": "string"
                      },
                      "notify_subscribers": {
                        "type": "boolean"
                      },
                      "thumbnail_asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "surface_expectation": {
                        "type": "string",
                        "const": "SHORT"
                      },
                      "brand_partner": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      "cover_asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "audio_name": {
                        "type": "string"
                      },
                      "trial_params": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      "is_ai_generated": {
                        "type": "boolean"
                      },
                      "branded_content_sponsor_ids": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "is_paid_partnership": {
                        "type": "boolean"
                      },
                      "media_options": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {}
                        }
                      },
                      "reply_to_id": {
                        "type": "string"
                      },
                      "quote_post_id": {
                        "type": "string"
                      },
                      "repost_target_id": {
                        "type": "string"
                      },
                      "reply_control": {
                        "type": "string"
                      },
                      "enable_reply_approvals": {
                        "type": "boolean"
                      },
                      "link_attachment": {
                        "type": "string",
                        "format": "uri"
                      },
                      "poll_attachment": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      "gif_attachment": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      "text_attachment": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      "text_entities": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {}
                        }
                      },
                      "is_spoiler_media": {
                        "type": "boolean"
                      },
                      "is_ghost_post": {
                        "type": "boolean"
                      },
                      "allowlisted_country_codes": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "crossreshare_to_ig": {
                        "type": "boolean"
                      },
                      "crossreshare_to_ig_dark_mode": {
                        "type": "boolean"
                      },
                      "auto_publish_text": {
                        "type": "boolean"
                      },
                      "publication_mode": {
                        "type": "string",
                        "enum": [
                          "PUBLISH",
                          "DRAFT"
                        ]
                      },
                      "backdated_time": {
                        "type": "number"
                      },
                      "backdated_time_granularity": {
                        "type": "string",
                        "enum": [
                          "year",
                          "month",
                          "day",
                          "hour",
                          "minute"
                        ]
                      },
                      "place": {
                        "type": "string"
                      },
                      "feed_targeting": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      "targeting": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      "child_attachments": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {}
                        }
                      },
                      "multi_share_end_card": {
                        "type": "boolean"
                      },
                      "multi_share_optimized": {
                        "type": "boolean"
                      },
                      "unpublished_content_type": {
                        "type": "string"
                      },
                      "no_story": {
                        "type": "boolean"
                      },
                      "crossposted_video_id": {
                        "type": "string"
                      },
                      "spherical": {
                        "type": "boolean"
                      }
                    }
                  },
                  "scheduled_at": {
                    "type": "string"
                  },
                  "display_timezone": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  },
                  "local_scheduled_at": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "schedule_timezone": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 80
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "schedule_dst_disambiguation": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "exact",
                          "earlier",
                          "later"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "schedule_intent_state": {
                    "type": "string",
                    "enum": [
                      "verified",
                      "legacy_unverified"
                    ]
                  },
                  "expires_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "scheduled",
                      "publishing",
                      "published",
                      "failed",
                      "expired",
                      "needs_reschedule",
                      "cancelled",
                      "deleted"
                    ]
                  },
                  "version": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  "automatic_retry_enabled": {
                    "type": "boolean"
                  },
                  "delete_requested_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "published_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "deleted_at": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "provider_post_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "permalink": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "updated_at": {
                    "type": "string"
                  },
                  "project_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "batch_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "source_ref": {
                    "anyOf": [
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "workspace_id",
                  "social_account_id",
                  "platform",
                  "destination",
                  "caption",
                  "hashtags",
                  "media",
                  "publish_options",
                  "scheduled_at",
                  "display_timezone",
                  "expires_at",
                  "status",
                  "version",
                  "automatic_retry_enabled",
                  "delete_requested_at",
                  "published_at",
                  "deleted_at",
                  "provider_post_id",
                  "permalink",
                  "created_at",
                  "updated_at",
                  "project_id",
                  "batch_id",
                  "source_ref"
                ]
              },
              "retry_allowed": {
                "type": "boolean"
              }
            },
            "required": [
              "item_id",
              "ordinal",
              "predecessor_post_id",
              "post",
              "retry_allowed"
            ]
          }
        },
        "expected_versions": {
          "type": "object",
          "propertyNames": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
          },
          "additionalProperties": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          }
        },
        "actions": {
          "minItems": 2,
          "maxItems": 2,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "action": {
                "type": "string",
                "enum": [
                  "resume",
                  "cancel"
                ]
              },
              "allowed": {
                "type": "boolean"
              },
              "reason_code": {
                "type": "string",
                "enum": [
                  "allowed",
                  "no_failed_items",
                  "resolution_required",
                  "retry_unavailable",
                  "terminal_state"
                ]
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "action",
              "allowed",
              "reason_code",
              "message"
            ]
          }
        }
      },
      "required": [
        "id",
        "workspace_id",
        "social_account_id",
        "idempotency_key",
        "item_count",
        "created_at",
        "items",
        "expected_versions",
        "actions"
      ]
    },
    "deduped": {
      "type": "boolean"
    }
  },
  "required": [
    "thread"
  ]
}

Feil og trygge nye forsøk

Kontroller HTTP-status og svarinnhold. En 400-valideringsfeil kan inneholde en ZodError; håndteringsfeil bruker feltene error, message og code. Behold request_id eller x-request-id for feilsøking, uten påloggingsopplysninger. Rett 401/403-tilgangsfeil før nye forsøk, og følg Retry-After ved 429. Hvis en skriveoperasjon er usikker eller returnerer 5xx, les det eksisterende resultatet først. Gjenbruk bare en idempotensnøkkel der det støttes; virkemåten ved nye forsøk varierer mellom operasjoner og garanterer ikke levering nøyaktig én gang.

Feilsøkingsveiledning

Eksempler

Disse eksemplene bruker fiktive verdier kontrollert mot skjemaene. Erstatt ID-ene med noen du har lov til å bruke, mediene med klare ressurser og datoene med bekreftet publiseringstidspunkt. Kontroller kontoens kvalifikasjon før en skriveoperasjon sendes inn. Siden sender ingen API-forespørsler.

Angi SOSOAPI_ACCESS_TOKEN på serveren din til legitimasjon som operasjonen godtar, og hold den unna nettleserkode. For en agent, bruk sosoapi auth login for innlogging gjennom nettleseren, og la CLI-et fornye legitimasjonen.

request.json

{
  "version": 1,
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "social_account_id": "22222222-2222-4222-8222-222222222222",
  "scheduled_at": "2099-01-15T09:00:00Z",
  "display_timezone": "UTC",
  "idempotency_key": "example-x-thread-0001",
  "items": [
    {
      "item_id": "99999999-9999-4999-8999-999999999991",
      "caption": "A fictional two-part announcement.",
      "hashtags": [],
      "media": [],
      "publish_options": {
        "post_type": "TEXT"
      }
    },
    {
      "item_id": "99999999-9999-4999-8999-999999999992",
      "caption": "The second part of this fictional announcement.",
      "hashtags": [],
      "media": [],
      "publish_options": {
        "post_type": "TEXT"
      }
    }
  ]
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/x-post-threads/create" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/x-post-threads/create", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "version": 1,
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "social_account_id": "22222222-2222-4222-8222-222222222222",
  "scheduled_at": "2099-01-15T09:00:00Z",
  "display_timezone": "UTC",
  "idempotency_key": "example-x-thread-0001",
  "items": [
    {
      "item_id": "99999999-9999-4999-8999-999999999991",
      "caption": "A fictional two-part announcement.",
      "hashtags": [],
      "media": [],
      "publish_options": {
        "post_type": "TEXT"
      }
    },
    {
      "item_id": "99999999-9999-4999-8999-999999999992",
      "caption": "The second part of this fictional announcement.",
      "hashtags": [],
      "media": [],
      "publish_options": {
        "post_type": "TEXT"
      }
    }
  ]
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /studio-api/x-post-threads/create < request.json

Syntetisk svareksempel

{
  "thread": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "id": "88888888-8888-4888-8888-888888888888",
    "social_account_id": "22222222-2222-4222-8222-222222222222",
    "idempotency_key": "example-x-thread-0001",
    "item_count": 2,
    "created_at": "2099-01-15T08:00:00Z",
    "items": [
      {
        "item_id": "99999999-9999-4999-8999-999999999991",
        "ordinal": 1,
        "predecessor_post_id": null,
        "retry_allowed": false,
        "post": {
          "id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa1",
          "workspace_id": "11111111-1111-4111-8111-111111111111",
          "social_account_id": "22222222-2222-4222-8222-222222222222",
          "platform": "x",
          "destination": {
            "social_account_id": "22222222-2222-4222-8222-222222222222",
            "platform": "x",
            "platform_user_id": "fictional-x-account",
            "account_label": "Fictional X account"
          },
          "caption": "A fictional two-part announcement.",
          "hashtags": [],
          "media": [],
          "publish_options": {
            "post_type": "TEXT"
          },
          "scheduled_at": "2099-01-15T09:00:00Z",
          "display_timezone": "UTC",
          "expires_at": null,
          "status": "scheduled",
          "version": 1,
          "automatic_retry_enabled": false,
          "delete_requested_at": null,
          "published_at": null,
          "deleted_at": null,
          "provider_post_id": null,
          "permalink": null,
          "project_id": null,
          "batch_id": null,
          "source_ref": null,
          "created_at": "2099-01-15T08:00:00Z",
          "updated_at": "2099-01-15T08:30:00Z"
        }
      },
      {
        "item_id": "99999999-9999-4999-8999-999999999992",
        "ordinal": 2,
        "predecessor_post_id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa1",
        "retry_allowed": false,
        "post": {
          "id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa2",
          "workspace_id": "11111111-1111-4111-8111-111111111111",
          "social_account_id": "22222222-2222-4222-8222-222222222222",
          "platform": "x",
          "destination": {
            "social_account_id": "22222222-2222-4222-8222-222222222222",
            "platform": "x",
            "platform_user_id": "fictional-x-account",
            "account_label": "Fictional X account"
          },
          "caption": "The second part of this fictional announcement.",
          "hashtags": [],
          "media": [],
          "publish_options": {
            "post_type": "TEXT"
          },
          "scheduled_at": "2099-01-15T09:00:00Z",
          "display_timezone": "UTC",
          "expires_at": null,
          "status": "scheduled",
          "version": 1,
          "automatic_retry_enabled": false,
          "delete_requested_at": null,
          "published_at": null,
          "deleted_at": null,
          "provider_post_id": null,
          "permalink": null,
          "project_id": null,
          "batch_id": null,
          "source_ref": null,
          "created_at": "2099-01-15T08:00:00Z",
          "updated_at": "2099-01-15T08:30:00Z"
        }
      }
    ],
    "expected_versions": {
      "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa1": 1,
      "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa2": 1
    },
    "actions": [
      {
        "action": "resume",
        "allowed": false,
        "reason_code": "no_failed_items",
        "message": "This example has no retryable failed items."
      },
      {
        "action": "cancel",
        "allowed": true,
        "reason_code": "allowed",
        "message": "Cancel the unpublished items in this fictional thread."
      }
    ]
  },
  "deduped": false
}

MCP: sosoapi_create_x_post_thread

Alle API-operasjoner Autentisering og tillatelser