Die Suche lädt erst bei Nutzung. Durchsuche unten alle Kategorien.

Planung und Veröffentlichung

Eignung geplanter Beiträge abrufen

Reine Lesevorprüfung je Ziel. Ergänze draft (caption, hashtags, scheduled_at, display_timezone, optional Ortszeit/DST) für Inhalts-/Zeitprüfungen; include_quota=true ergänzt einen unverbindlichen Zeitraum-Snapshot. Lade/importiere zuerst Medien und warte auf Bereitschaft. Ohne draft werden nur Konto/Medien geprüft. Reserviert nichts; create/dispatch prüfen Grenzen und Befugnisse erneut.

POST /studio-api/scheduled-posts/eligibility

Vertrag geprüft: · sha256:563d2d581da0ad29

Überblick

Reine Lesevorprüfung je Ziel. Ergänze draft (caption, hashtags, scheduled_at, display_timezone, optional Ortszeit/DST) für Inhalts-/Zeitprüfungen; include_quota=true ergänzt einen unverbindlichen Zeitraum-Snapshot. Lade/importiere zuerst Medien und warte auf Bereitschaft. Ohne draft werden nur Konto/Medien geprüft. Reserviert nichts; create/dispatch prüfen Grenzen und Befugnisse erneut.

Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.

Authentifizierung und Berechtigungen

Akzeptierte Zugangsdatenklassen
user_session, delegated_oauth, personal_access_token
Delegierte Funktion
agent:operate
Minimale Workspace-Rolle
viewer
Zugriffsumfang
Ressourcen, auf die dieser Nutzer zugreifen darf
Zustimmung für alle Workspaces erforderlich
Nein
Ändert Zustand
Nein
Nach Abschluss der Operation
synchronous_http_response

Ein Token nutzt nur Eigentümerrechte. Jede Anfrage prüft Workspace-Mitgliedschaft, Ressourceneigentum, gewählte Workspaces und Funktionen. core und full ändern sichtbare Tools; sie erteilen keinen Zugriff.

Anfragefelder

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Anfragefelder
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich
  • additionalProperties: false
workspace_idstringIm Elternobjekt erforderlich
  • 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)$"
include_quotabooleanOptional / Element—
targetsarrayIm Elternobjekt erforderlich
  • minItems: 1
  • maxItems: 50
targets[]objectOptional / Element
  • additionalProperties: false
targets[].social_account_idstringIm Elternobjekt erforderlich
  • 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)$"
targets[].mediaarrayIm Elternobjekt erforderlich
  • maxItems: 20
targets[].media[]objectOptional / Element
  • additionalProperties: false
targets[].media[].kindstringIm Elternobjekt erforderlich
  • enum: ["image","video"]
targets[].media[].urlstringIm Elternobjekt erforderlich
  • format: "uri"
targets[].media[].cover_urlstring | nullOptional / Element—
targets[].media[].cover_urlanyOf 1stringOptional / Element
  • format: "uri"
targets[].media[].cover_urlanyOf 2nullOptional / Element—
targets[].media[].cover_asset_idinteger | nullOptional / Element—
targets[].media[].cover_asset_idanyOf 1integerOptional / Element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].media[].cover_asset_idanyOf 2nullOptional / Element—
targets[].media[].asset_idinteger | nullOptional / Element—
targets[].media[].asset_idanyOf 1integerOptional / Element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].media[].asset_idanyOf 2nullOptional / Element—
targets[].media[].mime_typestring | nullOptional / Element—
targets[].media[].mime_typeanyOf 1stringOptional / Element
  • minLength: 1
  • maxLength: 160
targets[].media[].mime_typeanyOf 2nullOptional / Element—
targets[].link_urlstring | nullOptional / Element—
targets[].link_urlanyOf 1stringOptional / Element
  • format: "uri"
targets[].link_urlanyOf 2nullOptional / Element—
targets[].provider_payloadobjectIm Elternobjekt erforderlich—
targets[].provider_payloadoneOf 1objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.platformoneOf 1stringIm Elternobjekt erforderlich
  • const: "x"
targets[].provider_payload.publish_optionsoneOf 1objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 1stringIm Elternobjekt erforderlich
  • const: "TEXT"
targets[].provider_payloadoneOf 2objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.platformoneOf 2stringIm Elternobjekt erforderlich
  • const: "instagram"
targets[].provider_payload.publish_optionsoneOf 2objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 2stringIm Elternobjekt erforderlich
  • enum: ["IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO"]
targets[].provider_payload.publish_options.location_idoneOf 2stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.share_to_feedoneOf 2booleanOptional / Element—
targets[].provider_payload.publish_options.collaboratorsoneOf 2arrayOptional / Element
  • maxItems: 3
targets[].provider_payload.publish_options.collaborators[]oneOf 2stringOptional / Element
  • minLength: 1
  • maxLength: 30
targets[].provider_payload.publish_options.first_commentoneOf 2stringOptional / Element
  • minLength: 1
  • maxLength: 2200
targets[].provider_payload.publish_options.cover_asset_idoneOf 2integerOptional / Element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.thumb_offset_msoneOf 2integerOptional / Element
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.audio_nameoneOf 2stringOptional / Element
  • minLength: 1
  • maxLength: 100
targets[].provider_payload.publish_options.trial_paramsoneOf 2objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.trial_params.graduation_strategyoneOf 2stringIm Elternobjekt erforderlich
  • enum: ["MANUAL","SS_PERFORMANCE"]
targets[].provider_payload.publish_options.is_ai_generatedoneOf 2booleanOptional / Element—
targets[].provider_payload.publish_options.branded_content_sponsor_idsoneOf 2arrayOptional / Element
  • maxItems: 2
targets[].provider_payload.publish_options.branded_content_sponsor_ids[]oneOf 2stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.is_paid_partnershiponeOf 2booleanOptional / Element—
targets[].provider_payload.publish_options.media_optionsoneOf 2arrayOptional / Element
  • maxItems: 10
targets[].provider_payload.publish_options.media_options[]oneOf 2objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].asset_idoneOf 2integerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.media_options[].alt_textoneOf 2stringOptional / Element
  • minLength: 1
  • maxLength: 1000
targets[].provider_payload.publish_options.media_options[].user_tagsoneOf 2arrayOptional / Element
  • maxItems: 20
targets[].provider_payload.publish_options.media_options[].user_tags[]oneOf 2objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].user_tags[].usernameoneOf 2stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 30
targets[].provider_payload.publish_options.media_options[].user_tags[].xoneOf 2numberOptional / Element
  • minimum: 0
  • maximum: 1
targets[].provider_payload.publish_options.media_options[].user_tags[].yoneOf 2numberOptional / Element
  • minimum: 0
  • maximum: 1
targets[].provider_payload.publish_options.media_options[].product_tagsoneOf 2arrayOptional / Element
  • maxItems: 5
targets[].provider_payload.publish_options.media_options[].product_tags[]oneOf 2objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].product_tags[].product_idoneOf 2stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.media_options[].product_tags[].xoneOf 2numberOptional / Element
  • minimum: 0
  • maximum: 1
targets[].provider_payload.publish_options.media_options[].product_tags[].yoneOf 2numberOptional / Element
  • minimum: 0
  • maximum: 1
targets[].provider_payload.publish_options.media_options[].thumb_offset_msoneOf 2integerOptional / Element
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payloadoneOf 3objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.platformoneOf 3stringIm Elternobjekt erforderlich
  • const: "facebook"
targets[].provider_payload.publish_optionsoneOf 3objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 3stringIm Elternobjekt erforderlich
  • enum: ["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","REELS","STORY_IMAGE","STORY_VIDEO"]
targets[].provider_payload.publish_options.titleoneOf 3stringOptional / Element
  • maxLength: 255
targets[].provider_payload.publish_options.descriptiononeOf 3stringOptional / Element
  • maxLength: 5000
targets[].provider_payload.publish_options.publication_modeoneOf 3stringOptional / Element
  • enum: ["PUBLISH","DRAFT"]
targets[].provider_payload.publish_options.backdated_timeoneOf 3numberOptional / Element—
targets[].provider_payload.publish_options.backdated_time_granularityoneOf 3stringOptional / Element
  • enum: ["year","month","day","hour","minute"]
targets[].provider_payload.publish_options.placeoneOf 3stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.tagsoneOf 3arrayOptional / Element
  • maxItems: 50
targets[].provider_payload.publish_options.tags[]oneOf 3stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targetingoneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.age_minoneOf 3integerOptional / Element
  • minimum: 13
  • maximum: 65
targets[].provider_payload.publish_options.feed_targeting.age_maxoneOf 3integerOptional / Element
  • minimum: 13
  • maximum: 65
targets[].provider_payload.publish_options.feed_targeting.college_yearsoneOf 3arrayOptional / Element
  • maxItems: 100
targets[].provider_payload.publish_options.feed_targeting.college_years[]oneOf 3integerOptional / Element
  • minimum: 1900
  • maximum: 2200
targets[].provider_payload.publish_options.feed_targeting.education_statusesoneOf 3arrayOptional / Element
  • maxItems: 3
targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3numberOptional / Element—
targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 1numberOptional / Element
  • const: 1
targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 2numberOptional / Element
  • const: 2
targets[].provider_payload.publish_options.feed_targeting.education_statuses[]oneOf 3 / anyOf 3numberOptional / Element
  • const: 3
targets[].provider_payload.publish_options.feed_targeting.gendersoneOf 3arrayOptional / Element
  • maxItems: 2
targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3numberOptional / Element—
targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 1numberOptional / Element
  • const: 1
targets[].provider_payload.publish_options.feed_targeting.genders[]oneOf 3 / anyOf 2numberOptional / Element
  • const: 2
targets[].provider_payload.publish_options.feed_targeting.geo_locationsoneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.geo_locations.countriesoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 25
targets[].provider_payload.publish_options.feed_targeting.geo_locations.countries[]oneOf 3stringOptional / Element
  • pattern: "^[A-Z]{2}$"
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regionsoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[]oneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3string | integerIm Elternobjekt erforderlich—
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.geo_locations.citiesoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[]oneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3string | integerIm Elternobjekt erforderlich—
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].radiusoneOf 3numberOptional / Element
  • maximum: 1000
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.feed_targeting.geo_locations.cities[].distance_unitoneOf 3stringOptional / Element
  • enum: ["mile","kilometer"]
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zipsoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[]oneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3string | integerIm Elternobjekt erforderlich—
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_typesoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 2
targets[].provider_payload.publish_options.feed_targeting.geo_locations.location_types[]oneOf 3stringOptional / Element
  • enum: ["home","recent"]
targets[].provider_payload.publish_options.feed_targeting.interestsoneOf 3arrayOptional / Element
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3string | integerOptional / Element—
targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 1stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.feed_targeting.interests[]oneOf 3 / anyOf 2integerOptional / Element
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.localesoneOf 3arrayOptional / Element
  • maxItems: 250
targets[].provider_payload.publish_options.feed_targeting.locales[]oneOf 3integerOptional / Element
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.feed_targeting.relationship_statusesoneOf 3arrayOptional / Element
  • maxItems: 4
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3numberOptional / Element—
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 1numberOptional / Element
  • const: 1
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 2numberOptional / Element
  • const: 2
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 3numberOptional / Element
  • const: 3
targets[].provider_payload.publish_options.feed_targeting.relationship_statuses[]oneOf 3 / anyOf 4numberOptional / Element
  • const: 4
targets[].provider_payload.publish_options.targetingoneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.age_minoneOf 3numberOptional / Element—
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 1numberOptional / Element
  • const: 13
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 2numberOptional / Element
  • const: 15
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 3numberOptional / Element
  • const: 18
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 4numberOptional / Element
  • const: 21
targets[].provider_payload.publish_options.targeting.age_minoneOf 3 / anyOf 5numberOptional / Element
  • const: 25
targets[].provider_payload.publish_options.targeting.geo_locationsoneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.geo_locations.countriesoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 25
targets[].provider_payload.publish_options.targeting.geo_locations.countries[]oneOf 3stringOptional / Element
  • pattern: "^[A-Z]{2}$"
targets[].provider_payload.publish_options.targeting.geo_locations.regionsoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.targeting.geo_locations.regions[]oneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3string | integerIm Elternobjekt erforderlich—
targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.targeting.geo_locations.regions[].keyoneOf 3 / anyOf 2integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.targeting.geo_locations.citiesoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.targeting.geo_locations.cities[]oneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3string | integerIm Elternobjekt erforderlich—
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].keyoneOf 3 / anyOf 2integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].radiusoneOf 3numberOptional / Element
  • maximum: 1000
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.targeting.geo_locations.cities[].distance_unitoneOf 3stringOptional / Element
  • enum: ["mile","kilometer"]
targets[].provider_payload.publish_options.targeting.geo_locations.zipsoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 250
targets[].provider_payload.publish_options.targeting.geo_locations.zips[]oneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3string | integerIm Elternobjekt erforderlich—
targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 1stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.targeting.geo_locations.zips[].keyoneOf 3 / anyOf 2integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.targeting.geo_locations.location_typesoneOf 3arrayOptional / Element
  • minItems: 1
  • maxItems: 2
targets[].provider_payload.publish_options.targeting.geo_locations.location_types[]oneOf 3stringOptional / Element
  • enum: ["home","recent"]
targets[].provider_payload.publish_options.child_attachmentsoneOf 3arrayOptional / Element
  • minItems: 2
  • maxItems: 10
targets[].provider_payload.publish_options.child_attachments[]oneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.child_attachments[].linkoneOf 3stringIm Elternobjekt erforderlich
  • format: "uri"
targets[].provider_payload.publish_options.child_attachments[].nameoneOf 3stringOptional / Element
  • maxLength: 255
targets[].provider_payload.publish_options.child_attachments[].descriptiononeOf 3stringOptional / Element
  • maxLength: 1000
targets[].provider_payload.publish_options.child_attachments[].pictureoneOf 3stringIm Elternobjekt erforderlich
  • format: "uri"
targets[].provider_payload.publish_options.multi_share_end_cardoneOf 3booleanOptional / Element—
targets[].provider_payload.publish_options.multi_share_optimizedoneOf 3booleanOptional / Element—
targets[].provider_payload.publish_options.unpublished_content_typeoneOf 3stringOptional / Element
  • enum: ["SCHEDULED","SCHEDULED_RECURRING","DRAFT","PUBLISH_PENDING","ADS_POST","INLINE_CREATED","PUBLISHED","REVIEWABLE_BRANDED_CONTENT"]
targets[].provider_payload.publish_options.no_storyoneOf 3booleanOptional / Element—
targets[].provider_payload.publish_options.crossposted_video_idoneOf 3stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.sphericaloneOf 3booleanOptional / Element—
targets[].provider_payload.publish_options.media_optionsoneOf 3arrayOptional / Element
  • maxItems: 20
targets[].provider_payload.publish_options.media_options[]oneOf 3objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].asset_idoneOf 3integerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.media_options[].alt_text_customoneOf 3stringOptional / Element
  • minLength: 1
  • maxLength: 1000
targets[].provider_payloadoneOf 4objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.platformoneOf 4stringIm Elternobjekt erforderlich
  • const: "threads"
targets[].provider_payload.publish_optionsoneOf 4objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 4stringIm Elternobjekt erforderlich
  • enum: ["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]
targets[].provider_payload.publish_options.reply_to_idoneOf 4stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.quote_post_idoneOf 4stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.repost_target_idoneOf 4stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.reply_controloneOf 4stringOptional / Element
  • enum: ["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]
targets[].provider_payload.publish_options.enable_reply_approvalsoneOf 4booleanOptional / Element—
targets[].provider_payload.publish_options.link_attachmentoneOf 4stringOptional / Element
  • format: "uri"
targets[].provider_payload.publish_options.poll_attachmentoneOf 4objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.poll_attachment.option_aoneOf 4stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 25
targets[].provider_payload.publish_options.poll_attachment.option_boneOf 4stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 25
targets[].provider_payload.publish_options.poll_attachment.option_coneOf 4stringOptional / Element
  • minLength: 1
  • maxLength: 25
targets[].provider_payload.publish_options.poll_attachment.option_doneOf 4stringOptional / Element
  • minLength: 1
  • maxLength: 25
targets[].provider_payload.publish_options.gif_attachmentoneOf 4objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.gif_attachment.gif_idoneOf 4stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.gif_attachment.provideroneOf 4stringIm Elternobjekt erforderlich
  • const: "GIPHY"
targets[].provider_payload.publish_options.text_attachmentoneOf 4objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.text_attachment.plaintextoneOf 4stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 10000
targets[].provider_payload.publish_options.text_attachment.link_attachment_urloneOf 4stringOptional / Element
  • format: "uri"
targets[].provider_payload.publish_options.text_attachment.text_with_styling_infooneOf 4arrayOptional / Element
  • maxItems: 100
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[]oneOf 4objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].offsetoneOf 4integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].lengthoneOf 4integerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_infooneOf 4arrayIm Elternobjekt erforderlich
  • minItems: 1
targets[].provider_payload.publish_options.text_attachment.text_with_styling_info[].styling_info[]oneOf 4stringOptional / Element
  • enum: ["bold","italic","highlight","underline","strikethrough"]
targets[].provider_payload.publish_options.topic_tagoneOf 4stringOptional / Element
  • minLength: 1
  • maxLength: 50
targets[].provider_payload.publish_options.text_entitiesoneOf 4arrayOptional / Element
  • maxItems: 10
targets[].provider_payload.publish_options.text_entities[]oneOf 4objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.text_entities[].entity_typeoneOf 4stringIm Elternobjekt erforderlich
  • enum: ["SPOILER","spoiler"]
targets[].provider_payload.publish_options.text_entities[].offsetoneOf 4integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
targets[].provider_payload.publish_options.text_entities[].lengthoneOf 4integerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.is_spoiler_mediaoneOf 4booleanOptional / Element—
targets[].provider_payload.publish_options.is_ghost_postoneOf 4booleanOptional / Element—
targets[].provider_payload.publish_options.location_idoneOf 4stringOptional / Element
  • minLength: 1
  • maxLength: 256
targets[].provider_payload.publish_options.allowlisted_country_codesoneOf 4arrayOptional / Element
  • minItems: 1
  • maxItems: 249
targets[].provider_payload.publish_options.allowlisted_country_codes[]oneOf 4stringOptional / Element
  • pattern: "^[A-Z]{2}$"
targets[].provider_payload.publish_options.crossreshare_to_igoneOf 4booleanOptional / Element—
targets[].provider_payload.publish_options.crossreshare_to_ig_dark_modeoneOf 4booleanOptional / Element—
targets[].provider_payload.publish_options.auto_publish_textoneOf 4booleanOptional / Element—
targets[].provider_payload.publish_options.media_optionsoneOf 4arrayOptional / Element
  • maxItems: 20
targets[].provider_payload.publish_options.media_options[]oneOf 4objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.media_options[].asset_idoneOf 4integerIm Elternobjekt erforderlich
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.media_options[].alt_textoneOf 4stringOptional / Element
  • minLength: 1
  • maxLength: 1000
targets[].provider_payload.publish_options.media_options[].is_spoiler_mediaoneOf 4booleanOptional / Element—
targets[].provider_payloadoneOf 5objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.platformoneOf 5stringIm Elternobjekt erforderlich
  • const: "youtube"
targets[].provider_payload.publish_optionsoneOf 5objectIm Elternobjekt erforderlich
  • additionalProperties: false
targets[].provider_payload.publish_options.post_typeoneOf 5stringIm Elternobjekt erforderlich
  • const: "VIDEO"
targets[].provider_payload.publish_options.titleoneOf 5stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 100
targets[].provider_payload.publish_options.descriptiononeOf 5stringOptional / Element
  • maxLength: 5000
targets[].provider_payload.publish_options.tagsoneOf 5arrayOptional / Element
  • maxItems: 100
targets[].provider_payload.publish_options.tags[]oneOf 5stringOptional / Element
  • minLength: 1
  • maxLength: 500
targets[].provider_payload.publish_options.category_idoneOf 5stringOptional / Element—
targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 1stringOptional / Element
  • minLength: 0
  • maxLength: 0
targets[].provider_payload.publish_options.category_idoneOf 5 / anyOf 2stringOptional / Element
  • pattern: "^\\d+$"
targets[].provider_payload.publish_options.default_languageoneOf 5stringOptional / Element
  • minLength: 2
  • maxLength: 35
targets[].provider_payload.publish_options.localizationsoneOf 5objectOptional / Element
  • additionalProperties: {"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["title","description"],"additionalProperties":false}
targets[].provider_payload.publish_options.localizations.*oneOf 5objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.localizations.*.titleoneOf 5stringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 100
targets[].provider_payload.publish_options.localizations.*.descriptiononeOf 5stringIm Elternobjekt erforderlich
  • maxLength: 5000
targets[].provider_payload.publish_options.privacy_statusoneOf 5stringIm Elternobjekt erforderlich
  • enum: ["private","unlisted","public"]
targets[].provider_payload.publish_options.cancellation_modeoneOf 5stringIm Elternobjekt erforderlich
  • enum: ["DELETE","UNSCHEDULE_KEEP_PRIVATE"]
targets[].provider_payload.publish_options.licenseoneOf 5stringOptional / Element
  • enum: ["youtube","creativeCommon"]
targets[].provider_payload.publish_options.embeddableoneOf 5booleanOptional / Element—
targets[].provider_payload.publish_options.public_stats_viewableoneOf 5booleanOptional / Element—
targets[].provider_payload.publish_options.self_declared_made_for_kidsoneOf 5booleanOptional / Element—
targets[].provider_payload.publish_options.contains_synthetic_mediaoneOf 5booleanOptional / Element—
targets[].provider_payload.publish_options.has_paid_product_placementoneOf 5booleanOptional / Element—
targets[].provider_payload.publish_options.recording_dateoneOf 5stringOptional / 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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
targets[].provider_payload.publish_options.notify_subscribersoneOf 5booleanOptional / Element—
targets[].provider_payload.publish_options.thumbnail_asset_idoneOf 5integerOptional / Element
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
targets[].provider_payload.publish_options.surface_expectationoneOf 5stringOptional / Element
  • const: "SHORT"
targets[].provider_payload.publish_options.brand_partneroneOf 5objectOptional / Element
  • additionalProperties: false
targets[].provider_payload.publish_options.brand_partner.channel_idoneOf 5stringOptional / Element
  • pattern: "^UC[A-Za-z0-9_-]+$"
targets[].provider_payload.publish_options.brand_partner.channel_handleoneOf 5stringOptional / Element
  • pattern: "^@[A-Za-z0-9._-]+$"
targets[].draftobjectOptional / Element
  • additionalProperties: false
targets[].draft.captionstring | nullOptional / Element
  • default: null
targets[].draft.captionanyOf 1stringOptional / Element
  • maxLength: 5000
targets[].draft.captionanyOf 2nullOptional / Element—
targets[].draft.hashtagsarrayOptional / Element
  • maxItems: 100
  • default: []
targets[].draft.hashtags[]stringOptional / Element
  • maxLength: 100
targets[].draft.scheduled_atstringIm Elternobjekt erforderlich
  • 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)))$"
targets[].draft.display_timezonestringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 80
targets[].draft.local_scheduled_atstringOptional / Element
  • pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
targets[].draft.schedule_dst_disambiguationstringOptional / Element
  • enum: ["exact","earlier","later"]
targets[].draft.expires_atstring | nullOptional / Element—
targets[].draft.expires_atanyOf 1stringOptional / 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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
targets[].draft.expires_atanyOf 2nullOptional / Element—
Vollständiges JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "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)$"
    },
    "include_quota": {
      "type": "boolean"
    },
    "targets": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "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)$"
          },
          "media": {
            "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"
              }
            ]
          },
          "provider_payload": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "x"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "const": "TEXT"
                      }
                    },
                    "required": [
                      "post_type"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "instagram"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "enum": [
                          "IMAGE",
                          "VIDEO",
                          "CAROUSEL",
                          "REELS",
                          "STORY_IMAGE",
                          "STORY_VIDEO"
                        ]
                      },
                      "location_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "share_to_feed": {
                        "type": "boolean"
                      },
                      "collaborators": {
                        "maxItems": 3,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 30
                        }
                      },
                      "first_comment": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2200
                      },
                      "cover_asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "thumb_offset_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "audio_name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "trial_params": {
                        "type": "object",
                        "properties": {
                          "graduation_strategy": {
                            "type": "string",
                            "enum": [
                              "MANUAL",
                              "SS_PERFORMANCE"
                            ]
                          }
                        },
                        "required": [
                          "graduation_strategy"
                        ],
                        "additionalProperties": false
                      },
                      "is_ai_generated": {
                        "type": "boolean"
                      },
                      "branded_content_sponsor_ids": {
                        "maxItems": 2,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        }
                      },
                      "is_paid_partnership": {
                        "type": "boolean"
                      },
                      "media_options": {
                        "maxItems": 10,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "asset_id": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "alt_text": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1000
                            },
                            "user_tags": {
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "username": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 30
                                  },
                                  "x": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "y": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "username"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "product_tags": {
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "product_id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 256
                                  },
                                  "x": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  },
                                  "y": {
                                    "type": "number",
                                    "minimum": 0,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "product_id"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "thumb_offset_ms": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "asset_id"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "post_type"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "facebook"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "enum": [
                          "TEXT",
                          "LINK",
                          "IMAGE",
                          "MULTI_IMAGE",
                          "VIDEO",
                          "REELS",
                          "STORY_IMAGE",
                          "STORY_VIDEO"
                        ]
                      },
                      "title": {
                        "type": "string",
                        "maxLength": 255
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 5000
                      },
                      "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",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "tags": {
                        "maxItems": 50,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        }
                      },
                      "feed_targeting": {
                        "type": "object",
                        "properties": {
                          "age_min": {
                            "type": "integer",
                            "minimum": 13,
                            "maximum": 65
                          },
                          "age_max": {
                            "type": "integer",
                            "minimum": 13,
                            "maximum": 65
                          },
                          "college_years": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1900,
                              "maximum": 2200
                            }
                          },
                          "education_statuses": {
                            "maxItems": 3,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 1
                                },
                                {
                                  "type": "number",
                                  "const": 2
                                },
                                {
                                  "type": "number",
                                  "const": 3
                                }
                              ]
                            }
                          },
                          "genders": {
                            "maxItems": 2,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 1
                                },
                                {
                                  "type": "number",
                                  "const": 2
                                }
                              ]
                            }
                          },
                          "geo_locations": {
                            "type": "object",
                            "properties": {
                              "countries": {
                                "minItems": 1,
                                "maxItems": 25,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Z]{2}$"
                                }
                              },
                              "regions": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "cities": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    },
                                    "radius": {
                                      "type": "number",
                                      "exclusiveMinimum": 0,
                                      "maximum": 1000
                                    },
                                    "distance_unit": {
                                      "type": "string",
                                      "enum": [
                                        "mile",
                                        "kilometer"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "zips": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "location_types": {
                                "minItems": 1,
                                "maxItems": 2,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "home",
                                    "recent"
                                  ]
                                }
                              }
                            },
                            "additionalProperties": false
                          },
                          "interests": {
                            "maxItems": 250,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 256
                                },
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              ]
                            }
                          },
                          "locales": {
                            "maxItems": 250,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "relationship_statuses": {
                            "maxItems": 4,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 1
                                },
                                {
                                  "type": "number",
                                  "const": 2
                                },
                                {
                                  "type": "number",
                                  "const": 3
                                },
                                {
                                  "type": "number",
                                  "const": 4
                                }
                              ]
                            }
                          }
                        },
                        "additionalProperties": false
                      },
                      "targeting": {
                        "type": "object",
                        "properties": {
                          "age_min": {
                            "anyOf": [
                              {
                                "type": "number",
                                "const": 13
                              },
                              {
                                "type": "number",
                                "const": 15
                              },
                              {
                                "type": "number",
                                "const": 18
                              },
                              {
                                "type": "number",
                                "const": 21
                              },
                              {
                                "type": "number",
                                "const": 25
                              }
                            ]
                          },
                          "geo_locations": {
                            "type": "object",
                            "properties": {
                              "countries": {
                                "minItems": 1,
                                "maxItems": 25,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Z]{2}$"
                                }
                              },
                              "regions": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "cities": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    },
                                    "radius": {
                                      "type": "number",
                                      "exclusiveMinimum": 0,
                                      "maximum": 1000
                                    },
                                    "distance_unit": {
                                      "type": "string",
                                      "enum": [
                                        "mile",
                                        "kilometer"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "zips": {
                                "minItems": 1,
                                "maxItems": 250,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "key"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "location_types": {
                                "minItems": 1,
                                "maxItems": 2,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "home",
                                    "recent"
                                  ]
                                }
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "additionalProperties": false
                      },
                      "child_attachments": {
                        "minItems": 2,
                        "maxItems": 10,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "link": {
                              "type": "string",
                              "format": "uri"
                            },
                            "name": {
                              "type": "string",
                              "maxLength": 255
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 1000
                            },
                            "picture": {
                              "type": "string",
                              "format": "uri"
                            }
                          },
                          "required": [
                            "link",
                            "picture"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "multi_share_end_card": {
                        "type": "boolean"
                      },
                      "multi_share_optimized": {
                        "type": "boolean"
                      },
                      "unpublished_content_type": {
                        "type": "string",
                        "enum": [
                          "SCHEDULED",
                          "SCHEDULED_RECURRING",
                          "DRAFT",
                          "PUBLISH_PENDING",
                          "ADS_POST",
                          "INLINE_CREATED",
                          "PUBLISHED",
                          "REVIEWABLE_BRANDED_CONTENT"
                        ]
                      },
                      "no_story": {
                        "type": "boolean"
                      },
                      "crossposted_video_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "spherical": {
                        "type": "boolean"
                      },
                      "media_options": {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "asset_id": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "alt_text_custom": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1000
                            }
                          },
                          "required": [
                            "asset_id"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "post_type"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "threads"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "enum": [
                          "TEXT",
                          "IMAGE",
                          "VIDEO",
                          "CAROUSEL",
                          "REPOST"
                        ]
                      },
                      "reply_to_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "quote_post_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "repost_target_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "reply_control": {
                        "type": "string",
                        "enum": [
                          "everyone",
                          "accounts_you_follow",
                          "mentioned_only",
                          "parent_post_author_only",
                          "followers_only"
                        ]
                      },
                      "enable_reply_approvals": {
                        "type": "boolean"
                      },
                      "link_attachment": {
                        "type": "string",
                        "format": "uri"
                      },
                      "poll_attachment": {
                        "type": "object",
                        "properties": {
                          "option_a": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 25
                          },
                          "option_b": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 25
                          },
                          "option_c": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 25
                          },
                          "option_d": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 25
                          }
                        },
                        "required": [
                          "option_a",
                          "option_b"
                        ],
                        "additionalProperties": false
                      },
                      "gif_attachment": {
                        "type": "object",
                        "properties": {
                          "gif_id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 256
                          },
                          "provider": {
                            "type": "string",
                            "const": "GIPHY"
                          }
                        },
                        "required": [
                          "gif_id",
                          "provider"
                        ],
                        "additionalProperties": false
                      },
                      "text_attachment": {
                        "type": "object",
                        "properties": {
                          "plaintext": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 10000
                          },
                          "link_attachment_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "text_with_styling_info": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "offset": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "length": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "styling_info": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "enum": [
                                      "bold",
                                      "italic",
                                      "highlight",
                                      "underline",
                                      "strikethrough"
                                    ]
                                  }
                                }
                              },
                              "required": [
                                "offset",
                                "length",
                                "styling_info"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "plaintext"
                        ],
                        "additionalProperties": false
                      },
                      "topic_tag": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 50
                      },
                      "text_entities": {
                        "maxItems": 10,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "entity_type": {
                              "type": "string",
                              "enum": [
                                "SPOILER",
                                "spoiler"
                              ]
                            },
                            "offset": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "length": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "entity_type",
                            "offset",
                            "length"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "is_spoiler_media": {
                        "type": "boolean"
                      },
                      "is_ghost_post": {
                        "type": "boolean"
                      },
                      "location_id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      "allowlisted_country_codes": {
                        "minItems": 1,
                        "maxItems": 249,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "pattern": "^[A-Z]{2}$"
                        }
                      },
                      "crossreshare_to_ig": {
                        "type": "boolean"
                      },
                      "crossreshare_to_ig_dark_mode": {
                        "type": "boolean"
                      },
                      "auto_publish_text": {
                        "type": "boolean"
                      },
                      "media_options": {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "asset_id": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            "alt_text": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 1000
                            },
                            "is_spoiler_media": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "asset_id"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "post_type"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "const": "youtube"
                  },
                  "publish_options": {
                    "type": "object",
                    "properties": {
                      "post_type": {
                        "type": "string",
                        "const": "VIDEO"
                      },
                      "title": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 5000
                      },
                      "tags": {
                        "maxItems": 100,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 500
                        }
                      },
                      "category_id": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 0
                          },
                          {
                            "type": "string",
                            "pattern": "^\\d+$"
                          }
                        ]
                      },
                      "default_language": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 35
                      },
                      "localizations": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "type": "object",
                          "properties": {
                            "title": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 5000
                            }
                          },
                          "required": [
                            "title",
                            "description"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "privacy_status": {
                        "type": "string",
                        "enum": [
                          "private",
                          "unlisted",
                          "public"
                        ]
                      },
                      "cancellation_mode": {
                        "type": "string",
                        "enum": [
                          "DELETE",
                          "UNSCHEDULE_KEEP_PRIVATE"
                        ]
                      },
                      "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",
                        "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)))$"
                      },
                      "notify_subscribers": {
                        "type": "boolean"
                      },
                      "thumbnail_asset_id": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "surface_expectation": {
                        "type": "string",
                        "const": "SHORT"
                      },
                      "brand_partner": {
                        "type": "object",
                        "properties": {
                          "channel_id": {
                            "type": "string",
                            "pattern": "^UC[A-Za-z0-9_-]+$"
                          },
                          "channel_handle": {
                            "type": "string",
                            "pattern": "^@[A-Za-z0-9._-]+$"
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "post_type",
                      "title",
                      "privacy_status",
                      "cancellation_mode"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "platform",
                  "publish_options"
                ],
                "additionalProperties": false
              }
            ]
          },
          "draft": {
            "type": "object",
            "properties": {
              "caption": {
                "default": null,
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 5000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "hashtags": {
                "default": [],
                "maxItems": 100,
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 100
                }
              },
              "scheduled_at": {
                "type": "string",
                "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": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80
              },
              "local_scheduled_at": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"
              },
              "schedule_dst_disambiguation": {
                "type": "string",
                "enum": [
                  "exact",
                  "earlier",
                  "later"
                ]
              },
              "expires_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "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)))$"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "scheduled_at",
              "display_timezone"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "social_account_id",
          "media",
          "provider_payload"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "workspace_id",
    "targets"
  ],
  "additionalProperties": false
}

Antwort und Abschluss

HTTP-Erfolgsstatus: 200. Wenn die Operation abgeschlossen ist: synchronous_http_response.

Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Antwort und Abschluss
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich—
destinationsarrayIm Elternobjekt erforderlich
  • maxItems: 50
destinations[]objectOptional / Element—
destinations[].social_account_idstringIm Elternobjekt erforderlich
  • 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)$"
destinations[].platformstring | nullIm Elternobjekt erforderlich—
destinations[].platformanyOf 1stringIm Elternobjekt erforderlich
  • enum: ["instagram","threads","facebook","youtube","x"]
destinations[].platformanyOf 2nullIm Elternobjekt erforderlich—
destinations[].statusstringIm Elternobjekt erforderlich
  • enum: ["eligible","ineligible","unknown"]
destinations[].reason_codestringIm Elternobjekt erforderlich
  • enum: ["eligible","account_not_found","account_disconnected","account_action_required","account_temporarily_unavailable","account_publishing_restricted","account_readiness_unknown","account_sponsorship_required","organization_channel_disconnected","provider_authorization_revoke_pending","organization_channel_not_primary","organization_channel_transition","organization_new_work_blocked","content_incompatible","schedule_incompatible","schedule_check_unavailable","capability_unavailable","capability_unknown"]
destinations[].messagestringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 500
destinations[].required_capabilitiesarrayIm Elternobjekt erforderlich
  • maxItems: 20
destinations[].required_capabilities[]stringOptional / Element
  • minLength: 1
  • maxLength: 100
quotaobjectOptional / Element—
quota.statusstringIm Elternobjekt erforderlich
  • enum: ["available","insufficient","unknown","not_enforced"]
quota.requested_destinationsintegerIm Elternobjekt erforderlich
  • maximum: 50
  • exclusiveMinimum: 0
quota.remaining_publishesinteger | nullIm Elternobjekt erforderlich—
quota.remaining_publishesanyOf 1integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
quota.remaining_publishesanyOf 2nullIm Elternobjekt erforderlich—
quota.remaining_pending_postsinteger | nullIm Elternobjekt erforderlich—
quota.remaining_pending_postsanyOf 1integerIm Elternobjekt erforderlich
  • minimum: 0
  • maximum: 9007199254740991
quota.remaining_pending_postsanyOf 2nullIm Elternobjekt erforderlich—
quota.period_startstring | nullIm Elternobjekt erforderlich—
quota.period_startanyOf 1stringIm Elternobjekt erforderlich
  • 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)))$"
quota.period_startanyOf 2nullIm Elternobjekt erforderlich—
quota.period_endstring | nullIm Elternobjekt erforderlich—
quota.period_endanyOf 1stringIm Elternobjekt erforderlich
  • 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)))$"
quota.period_endanyOf 2nullIm Elternobjekt erforderlich—
quota.checked_atstringIm Elternobjekt erforderlich
  • 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)))$"
quota.reservedbooleanIm Elternobjekt erforderlich
  • const: false
Vollständiges JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "destinations": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "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)$"
          },
          "platform": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "instagram",
                  "threads",
                  "facebook",
                  "youtube",
                  "x"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "eligible",
              "ineligible",
              "unknown"
            ]
          },
          "reason_code": {
            "type": "string",
            "enum": [
              "eligible",
              "account_not_found",
              "account_disconnected",
              "account_action_required",
              "account_temporarily_unavailable",
              "account_publishing_restricted",
              "account_readiness_unknown",
              "account_sponsorship_required",
              "organization_channel_disconnected",
              "provider_authorization_revoke_pending",
              "organization_channel_not_primary",
              "organization_channel_transition",
              "organization_new_work_blocked",
              "content_incompatible",
              "schedule_incompatible",
              "schedule_check_unavailable",
              "capability_unavailable",
              "capability_unknown"
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "required_capabilities": {
            "maxItems": 20,
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          }
        },
        "required": [
          "social_account_id",
          "platform",
          "status",
          "reason_code",
          "message",
          "required_capabilities"
        ]
      }
    },
    "quota": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "available",
            "insufficient",
            "unknown",
            "not_enforced"
          ]
        },
        "requested_destinations": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 50
        },
        "remaining_publishes": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "remaining_pending_posts": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "period_start": {
          "anyOf": [
            {
              "type": "string",
              "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)))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "period_end": {
          "anyOf": [
            {
              "type": "string",
              "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)))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "checked_at": {
          "type": "string",
          "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)))$"
        },
        "reserved": {
          "type": "boolean",
          "const": false
        }
      },
      "required": [
        "status",
        "requested_destinations",
        "remaining_publishes",
        "remaining_pending_posts",
        "period_start",
        "period_end",
        "checked_at",
        "reserved"
      ]
    }
  },
  "required": [
    "destinations"
  ]
}

Fehler und sichere Wiederholungen

Prüfe HTTP-Status und Antwortinhalt. Ein 400-Validierungsfehler kann einen ZodError enthalten; Handler-Fehler verwenden die Felder error, message und code. Bewahre request_id oder x-request-id zur Diagnose ohne Zugangsdaten auf. Behebe 401/403-Zugriffsfehler vor einem erneuten Versuch und beachte Retry-After bei 429. Ist ein Schreibvorgang ungewiss oder liefert 5xx, lies zuerst das bestehende Ergebnis. Verwende einen Idempotenzschlüssel nur wieder, wo dies unterstützt wird; Wiederholungen unterscheiden sich je nach Operation und garantieren keine genau einmalige Zustellung.

Anleitung zur Fehlerbehebung

Beispiele

Diese Beispiele nutzen anhand der Schemas geprüfte fiktive Werte. Ersetze IDs durch autorisierte IDs, Medien durch bereite Assets und Daten durch bestätigte Veröffentlichungszeiten. Prüfe Kontoeignung vor Schreibvorgängen. Diese Seite sendet keine API-Anfragen.

Setze SOSOAPI_ACCESS_TOKEN auf deinem Server auf akzeptierte Zugangsdaten dieser Operation und halte es aus Browsercode heraus. Für Agenten nutze sosoapi auth login zur Browseranmeldung und lass die CLI Zugangsdaten erneuern.

request.json

{
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "targets": [
    {
      "social_account_id": "11111111-1111-4111-8111-111111111111",
      "media": [],
      "provider_payload": {
        "platform": "x",
        "publish_options": {
          "post_type": "TEXT"
        }
      }
    }
  ]
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/eligibility" \
  -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/scheduled-posts/eligibility", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "targets": [
    {
      "social_account_id": "11111111-1111-4111-8111-111111111111",
      "media": [],
      "provider_payload": {
        "platform": "x",
        "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/scheduled-posts/eligibility < request.json

Synthetisches Antwortbeispiel

{
  "destinations": []
}

MCP: sosoapi_get_scheduled_post_eligibility