{"openapi":"3.1.0","info":{"title":"Integrity Studio API","version":"1.0.0","description":"Create a key in Studio → API. Bearer authentication, workspace and model isolation. Limit: 120 requests/minute/key; writes and Instagram catalog checks share a budget of 10/minute. Publishing is asynchronous: HTTP 201 means created, not published. Poll status. Do not resend publish_unconfirmed or human_verification_required jobs."},"servers":[{"url":"https://app.integritymodels.world/api/v1"}],"paths":{"/models":{"get":{"operationId":"listModels","summary":"listModels","description":"Requires models:read.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Model"}}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/models/{id}":{"get":{"operationId":"getModel","summary":"getModel","description":"Requires models:read.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Model"}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}}]}},"/models/{id}/locations":{"get":{"operationId":"searchInstagramLocations","summary":"searchInstagramLocations","description":"Requires models:read.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","description":"Copy a location object returned by the locations endpoint.","required":["name","facebook_places_id"],"properties":{"name":{"type":"string"},"facebook_places_id":{"type":"string"},"external_source":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"},"address":{"type":"string"}}}}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}},{"name":"q","in":"query","schema":{"type":"string","minLength":2,"maxLength":100},"required":true}]}},"/models/{id}/facebook":{"get":{"operationId":"checkFacebookSharing","summary":"checkFacebookSharing","description":"Requires models:read.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"linked":{"type":"boolean","default":false},"available":{"type":"boolean","default":false},"canAttempt":{"type":"boolean","default":false},"reason":{"type":"string"},"destinations":{"type":"array","items":{"type":"object"}}}}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}},{"name":"format","in":"query","schema":{"type":"string","enum":["post","carousel","reel"],"default":"reel"}}]}},"/publications":{"get":{"operationId":"listPublications","summary":"listPublications","description":"Requires publications:read.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Publication"}},"meta":{"type":"object","properties":{"limit":{"type":"integer"},"nextCursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"modelId","in":"query","schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string","enum":["instagram","youtube","tiktok","facebook","threads"],"default":"instagram"}},{"name":"status","in":"query","schema":{"type":"string","enum":["cancelled","claimed","draft","failed","human_verification_required","publish_unconfirmed","published","publishing","queued","retryable_failure","scheduled","staging_media"]}}]},"post":{"operationId":"createPublication","summary":"createPublication","description":"Requires publications:write.","security":[{"ApiKey":[]}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Publication"}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePublication"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"},"description":"Reuse exactly the same key and body for retries. Never change key after an unknown result."}]}},"/publications/{id}":{"get":{"operationId":"getPublication","summary":"getPublication","description":"Requires publications:read.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Publication"}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}}]}},"/publications/{id}/schedule":{"post":{"operationId":"schedulePublication","summary":"schedulePublication","description":"Requires publications:write.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Publication"}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["runAt"],"additionalProperties":false,"properties":{"runAt":{"type":"string","format":"date-time","description":"ISO 8601 with timezone."}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}}]}},"/publications/{id}/publish":{"post":{"operationId":"publishPublication","summary":"publishPublication","description":"Requires publications:write.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Publication"}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}}]}},"/publications/{id}/cancel":{"post":{"operationId":"cancelPublication","summary":"cancelPublication","description":"Requires publications:write.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Publication"}}}}}},"400":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}}},"500":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error; inspect error.code and error.requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}}]}}},"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"igty_..."}},"schemas":{"CreatePublication":{"type":"object","additionalProperties":false,"required":["modelId","media"],"properties":{"modelId":{"type":"string","pattern":"^[a-f0-9]{32}$"},"platform":{"type":"string","enum":["instagram","youtube","tiktok","facebook","threads"],"default":"instagram"},"media":{"type":"array","minItems":0,"maxItems":10,"items":{"type":"object","required":["data"],"properties":{"data":{"type":"string","description":"Base64 JPEG, PNG or MP4. Total decoded media ≤100 MiB; request ≤140 MiB."}}}},"caption":{"type":"string","default":""},"runAt":{"type":"string","format":"date-time","description":"ISO 8601 with timezone."},"publishNow":{"type":"boolean","default":false},"publicationKind":{"type":"string","enum":["feed","story"],"default":"feed"},"instagramFormat":{"type":"string","enum":["post","carousel","reel","story","text","poll","quote","reply","repost"]},"location":{"type":"object","description":"Copy a location object returned by the locations endpoint.","required":["name","facebook_places_id"],"properties":{"name":{"type":"string"},"facebook_places_id":{"type":"string"},"external_source":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"},"address":{"type":"string"}}},"facebookDestinationType":{"type":"string","enum":["USER","PAGE"]},"youtubeVisibility":{"type":"string","enum":["public","unlisted","private"]},"tiktokVisibility":{"type":"string","enum":["public","friends","private"]},"youtubeTags":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"userTags":{"type":"array","items":{"type":"object"}},"storyTextX":{"type":"number","minimum":0,"maximum":1},"storyTextY":{"type":"number","minimum":0,"maximum":1},"storyTextSize":{"type":"integer","minimum":48,"maximum":140},"metaAiLabel":{"type":"boolean","default":false},"aiLabel":{"type":"boolean","default":false},"recommendedMusic":{"type":"boolean","default":false},"shareToStory":{"type":"boolean","default":false},"shareToFacebook":{"type":"boolean","default":false},"madeForKids":{"type":"boolean","default":false},"containsSyntheticMedia":{"type":"boolean","default":false},"storyTextBackground":{"type":"boolean","default":false},"facebookProfileId":{"type":"string"},"threadsProfileId":{"type":"string"},"musicQuery":{"type":"string"},"musicAssetId":{"type":"string"},"facebookDestinationId":{"type":"string"},"facebookDestinationProfileId":{"type":"string"},"youtubeProfileId":{"type":"string"},"tiktokProfileId":{"type":"string"},"youtubeTitle":{"type":"string"},"storyText":{"type":"string"},"storyFont":{"type":"string"},"storyTextPosition":{"type":"string"},"storyTextColor":{"type":"string"},"facebookVisibility":{"type":"string","enum":["EVERYONE","FRIENDS","SELF"]},"metaOptions":{"type":"object","additionalProperties":false,"properties":{"facebook":{"type":"object","additionalProperties":false,"properties":{"locationId":{"type":"string"},"locationName":{"type":"string"},"musicAssetId":{"type":"string"},"musicName":{"type":"string"},"shareToStory":{"type":"boolean","default":false},"replyControl":{"type":"string"},"spoiler":{"type":"boolean","default":false},"altText":{"type":"string"},"pollOptions":{"type":"array","items":{"type":"string"},"maxItems":4},"sourceUrl":{"type":"string"}}},"threads":{"type":"object","additionalProperties":false,"properties":{"locationId":{"type":"string"},"locationName":{"type":"string"},"musicAssetId":{"type":"string"},"musicName":{"type":"string"},"shareToStory":{"type":"boolean","default":false},"replyControl":{"type":"string"},"spoiler":{"type":"boolean","default":false},"altText":{"type":"string"},"pollOptions":{"type":"array","items":{"type":"string"},"maxItems":4},"sourceUrl":{"type":"string"}}}}}},"description":"Supply publishNow=true or a future runAt. One platform per request. Video feed uploads become Reels. AI, story and Facebook sharing default to false."},"Model":{"type":"object","required":["id","name","username","active"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"active":{"type":"boolean"}}},"Publication":{"type":"object","properties":{"id":{"type":"string"},"modelId":{"type":"string"},"targetUsername":{"type":"string"},"platform":{"type":"string","enum":["instagram","youtube","tiktok","facebook","threads"],"default":"instagram"},"caption":{"type":"string"},"status":{"type":"string","enum":["cancelled","claimed","draft","failed","human_verification_required","publish_unconfirmed","published","publishing","queued","retryable_failure","scheduled","staging_media"]},"runAt":{"type":"string","format":"date-time","description":"ISO 8601 with timezone."},"resultUrl":{"type":["string","null"]},"error":{"type":["string","null"],"description":"Safe category; technical details are only available in Studio."},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 with timezone."},"updatedAt":{"type":"string","format":"date-time","description":"ISO 8601 with timezone."},"publicationKind":{"type":"string","enum":["feed","story"],"default":"feed"},"aiLabel":{"type":"boolean","default":false},"shareToStory":{"type":"boolean","default":false},"shareToFacebook":{"type":"boolean","default":false}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}}}}}}}}