{"openapi":"3.1.0","info":{"title":"SocialRobot.io Scheduler API","description":"\nAccess our API to efficiently schedule and manage your social media posts across multiple platforms.\n\nHTTP API consumers should authenticate with an API key in the `x-api-key` header.\n\nMCP consumers should connect to <code>/api/mcp</code> and use OAuth discovery from <code>/.well-known/oauth-protected-resource</code>, <code>/.well-known/oauth-authorization-server/api/auth</code>, and <code>/api/auth/.well-known/openid-configuration</code>. Dynamic client registration is available at <code>/api/auth/oauth2/register</code> when enabled.\n\nAdditional machine-readable docs are available at <code>/api/llm.txt</code>.\n\nFor detailed documentation and to utilize the assistant, click the link below:\n\n<a href=\"/scheduler/api-docs?tab=assistant\" class=\"inline-flex border border-solid items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive text-primary underline-offset-4 hover:underline\">Go to Assistant</a>\n\n","version":"1.0.0"},"servers":[{"url":"https://socialrobot.io/api"}],"tags":[{"name":"Social Media"}],"paths":{"/posts":{"post":{"operationId":"socialPost-create","summary":"Create a post across one or more connected platforms","description":"Create a single scheduled item that can target multiple connected social accounts at once.","tags":["Posts"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"instagramTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"IMAGE"},"mediaUrl":{"type":"string"},"altText":{"type":"string","maxLength":1000},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]},"isStory":{"type":"boolean"}},"required":["accountId","caption","mediaType","mediaUrl"]},{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"VIDEO"},"mediaUrl":{"type":"string"},"coverUrl":{"type":"string"},"thumbOffset":{"type":"integer","minimum":0,"maximum":9007199254740991},"shareToFeed":{"type":"boolean"},"isStory":{"default":false,"type":"boolean"},"isReel":{"default":false,"type":"boolean"}},"required":["accountId","caption","mediaType","mediaUrl"]},{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"CAROUSEL"},"medias":{"minItems":2,"maxItems":10,"type":"array","items":{"oneOf":[{"type":"object","properties":{"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"altText":{"type":"string","maxLength":1000},"mediaType":{"type":"string","const":"IMAGE"},"mediaUrl":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]},{"type":"object","properties":{"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"altText":{"type":"string","maxLength":1000},"mediaType":{"type":"string","const":"VIDEO"},"mediaUrl":{"type":"string"},"coverUrl":{"type":"string"}},"required":["mediaType","mediaUrl"]}],"type":"object"}},"isStory":{"type":"boolean"},"isReel":{"type":"boolean"}},"required":["accountId","caption","mediaType","medias","isStory","isReel"]}],"type":"object"}},"pinterestTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"accountId":{"type":"string"},"boardId":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":800},"altText":{"type":"string","maxLength":500},"link":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"string","const":""}]},"dominantColor":{"type":"string"},"boardSectionId":{"type":"string"},"isStandard":{"type":"boolean"},"mediaType":{"type":"string","const":"IMAGE"},"medias":{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}},"required":["accountId","boardId","mediaType","medias"]},{"type":"object","properties":{"accountId":{"type":"string"},"boardId":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":800},"altText":{"type":"string","maxLength":500},"link":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"string","const":""}]},"dominantColor":{"type":"string"},"boardSectionId":{"type":"string"},"isStandard":{"type":"boolean"},"mediaType":{"type":"string","const":"VIDEO"},"medias":{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"coverImageUrl":{"type":"string","format":"uri"},"coverImageContentType":{"type":"string"},"coverImageKeyFrameTime":{"type":"number"}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}},"required":["accountId","boardId","mediaType","medias"]}],"type":"object"}},"twitterTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string"},"medias":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO","GIF"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}},"segments":{"maxItems":24,"type":"array","items":{"type":"object","properties":{"caption":{"type":"string"},"medias":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO","GIF"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}}},"required":["caption","medias"]}}},"required":["accountId","caption","medias"]}},"linkedinTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"visibility":{"default":"PUBLIC","type":"string","enum":["PUBLIC","CONNECTIONS"]},"caption":{"type":"string","maxLength":3000},"documentTitle":{"type":"string","maxLength":200},"firstComment":{"type":"string","maxLength":1250},"captionMentions":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["person","organization"]},"urn":{"type":"string","minLength":1},"displayText":{"type":"string","minLength":1,"maxLength":200},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"imageUrl":{"type":"string","minLength":1}},"required":["type","urn","displayText","start","length"]}},"firstCommentMentions":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["person","organization"]},"urn":{"type":"string","minLength":1},"displayText":{"type":"string","minLength":1,"maxLength":200},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"imageUrl":{"type":"string","minLength":1}},"required":["type","urn","displayText","start","length"]}},"poll":{"type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":140},"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"duration":{"default":"THREE_DAYS","type":"string","enum":["ONE_DAY","THREE_DAYS","SEVEN_DAYS","FOURTEEN_DAYS"]}},"required":["question","options"]},"article":{"type":"object","properties":{"source":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1,"maxLength":400},"description":{"type":"string","maxLength":4086},"thumbnailUrl":{"type":"string","format":"uri"},"thumbnailAltText":{"type":"string","maxLength":120}},"required":["source","title"]},"geoLocations":{"maxItems":150,"type":"array","items":{"type":"object","properties":{"urn":{"type":"string","pattern":"^urn:li:geo:\\d+$"},"displayText":{"type":"string","minLength":1,"maxLength":200}},"required":["urn","displayText"]}},"medias":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"altText":{"type":"string","maxLength":120},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"altText":{"type":"string","maxLength":120},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]},"videoMetadata":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"aspectRatioWidth":{"type":"number"},"aspectRatioHeight":{"type":"number"}}}},"required":["mediaUrl","videoMetadata"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"DOCUMENT"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":200}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}],"type":"object"}},"required":["accountId","caption"]}},"blueskyTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":300},"embed":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"object","properties":{"alt":{"type":"string"},"url":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["url"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"alt":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["url"]}}},"required":["mediaType","medias"]}],"type":"object"}},"required":["accountId","caption"]}},"tiktokTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"privacyLevel":{"type":"string","enum":["PUBLIC","FRIENDS","FOLLOWERS","PRIVATE"]},"disableComment":{"type":"boolean"},"autoAddMusic":{"type":"boolean"},"disableDuet":{"type":"boolean"},"disableStitch":{"type":"boolean"},"commercialContent":{"type":"object","properties":{"isCommercialContent":{"default":false,"type":"boolean"},"yourBrand":{"default":false,"type":"boolean"},"brandedContent":{"default":false,"type":"boolean"}}},"photoCoverIndex":{"type":"integer","minimum":0,"maximum":9007199254740991},"isAigc":{"type":"boolean"},"videoCoverTimestampMs":{"type":"integer","minimum":0,"maximum":9007199254740991},"medias":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":35,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}],"type":"object"},"postMode":{"default":"DIRECT_POST","type":"string","enum":["DIRECT_POST","UPLOAD"]},"title":{"type":"string","maxLength":90},"videoDurationSec":{"type":"number","exclusiveMinimum":0}},"required":["accountId","caption","medias"]}},"mastodonTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":500},"visibility":{"default":"public","type":"string","enum":["public","unlisted","private","direct"]},"sensitive":{"default":false,"type":"boolean"},"spoilerText":{"type":"string"},"language":{"type":"string"},"poll":{"type":"object","properties":{"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":50}},"required":["title"]}},"expiresIn":{"type":"number","minimum":300,"maximum":604800},"multiple":{"default":false,"type":"boolean"},"hideTotals":{"default":false,"type":"boolean"}},"required":["options","expiresIn"]},"medias":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"mediaUrl":{"type":"string"},"size":{"type":"number"},"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"alt":{"type":"string","maxLength":1500},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["name","mediaUrl","size","mediaType"]}}},"required":["accountId","caption","medias"]}},"threadsTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":500},"medias":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}},"userTags":{"type":"array","items":{}},"hashtags":{"type":"array","items":{"type":"string"}},"linkAttachment":{"type":"string","format":"uri"},"topicTag":{"type":"string","minLength":1,"maxLength":50},"poll":{"type":"object","properties":{"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":25}}},"required":["options"]},"segments":{"maxItems":19,"type":"array","items":{"type":"object","properties":{"caption":{"type":"string","maxLength":500},"medias":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}}},"required":["caption","medias"]}}},"required":["accountId","caption","medias"]}},"facebookTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"default":"","type":"string","maxLength":63206},"medias":{"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string"},"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl","mediaType"]}},"isReel":{"default":false,"type":"boolean"},"isSlideshow":{"default":false,"type":"boolean"},"isStory":{"default":false,"type":"boolean"},"slideshowDuration":{"default":1750,"type":"number","minimum":1750,"maximum":10000},"slideshowTransition":{"default":250,"type":"number","minimum":250,"maximum":2000},"coverUrl":{"type":"string"},"location":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["id","name"]}},"required":["accountId","medias"]}}},"required":["scheduledFor","instagramTargets","pinterestTargets","twitterTargets","linkedinTargets","blueskyTargets","tiktokTargets","mastodonTargets","threadsTargets","facebookTargets"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"429":{"description":"Too many requests - daily API quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.TOO_MANY_REQUESTS"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"get":{"operationId":"socialPost.getAll","summary":"List posts for the authenticated user","description":"Returns the authenticated user’s draft, scheduled, publishing, or published posts with optional filtering and cursor-based pagination.","tags":["Posts"],"security":[{"apiKey":[]}],"parameters":[{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string"},"description":"The API key to use for the request"},{"name":"status","in":"query","schema":{"type":"string"},"description":"Optional aggregate status filter"},{"name":"platform","in":"query","schema":{"type":"string"},"description":"Optional platform filter"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"Optional page size limit"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Optional pagination cursor"}],"responses":{"200":{"description":"Posts fetched successfully","content":{"application/json":{"schema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object","additionalProperties":true}},"nextCursor":{"type":"string"}},"required":["posts"]}}}}}}},"/posts/{id}":{"delete":{"operationId":"socialPost-delete","summary":"Delete a scheduled post","description":"Deletes a scheduled or draft post that belongs to the authenticated user.","tags":["Posts"],"security":[{"apiKey":[]}],"parameters":[{"in":"path","name":"id","schema":{"description":"The post ID returned when the post was created","type":"string"},"required":true,"description":"The post ID returned when the post was created"}],"responses":{"200":{"description":"Post deleted successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"404":{"description":"Post not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"patch":{"operationId":"socialPost-update","summary":"Update an existing draft or scheduled post","description":"Replaces caption, media, schedule, and platform targets for a draft or scheduled post.","tags":["Posts"],"security":[{"apiKey":[]}],"parameters":[{"in":"path","name":"id","schema":{"description":"The post ID to update","type":"string"},"required":true,"description":"The post ID to update"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"instagramTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"IMAGE"},"mediaUrl":{"type":"string"},"altText":{"type":"string","maxLength":1000},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]},"isStory":{"type":"boolean"}},"required":["accountId","caption","mediaType","mediaUrl"]},{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"VIDEO"},"mediaUrl":{"type":"string"},"coverUrl":{"type":"string"},"thumbOffset":{"type":"integer","minimum":0,"maximum":9007199254740991},"shareToFeed":{"type":"boolean"},"isStory":{"default":false,"type":"boolean"},"isReel":{"default":false,"type":"boolean"}},"required":["accountId","caption","mediaType","mediaUrl"]},{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"CAROUSEL"},"medias":{"minItems":2,"maxItems":10,"type":"array","items":{"oneOf":[{"type":"object","properties":{"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"altText":{"type":"string","maxLength":1000},"mediaType":{"type":"string","const":"IMAGE"},"mediaUrl":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]},{"type":"object","properties":{"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"altText":{"type":"string","maxLength":1000},"mediaType":{"type":"string","const":"VIDEO"},"mediaUrl":{"type":"string"},"coverUrl":{"type":"string"}},"required":["mediaType","mediaUrl"]}],"type":"object"}},"isStory":{"type":"boolean"},"isReel":{"type":"boolean"}},"required":["accountId","caption","mediaType","medias","isStory","isReel"]}],"type":"object"}},"pinterestTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"accountId":{"type":"string"},"boardId":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":800},"altText":{"type":"string","maxLength":500},"link":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"string","const":""}]},"dominantColor":{"type":"string"},"boardSectionId":{"type":"string"},"isStandard":{"type":"boolean"},"mediaType":{"type":"string","const":"IMAGE"},"medias":{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}},"required":["accountId","boardId","mediaType","medias"]},{"type":"object","properties":{"accountId":{"type":"string"},"boardId":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":800},"altText":{"type":"string","maxLength":500},"link":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"string","const":""}]},"dominantColor":{"type":"string"},"boardSectionId":{"type":"string"},"isStandard":{"type":"boolean"},"mediaType":{"type":"string","const":"VIDEO"},"medias":{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"coverImageUrl":{"type":"string","format":"uri"},"coverImageContentType":{"type":"string"},"coverImageKeyFrameTime":{"type":"number"}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}},"required":["accountId","boardId","mediaType","medias"]}],"type":"object"}},"twitterTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string"},"medias":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO","GIF"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}},"segments":{"maxItems":24,"type":"array","items":{"type":"object","properties":{"caption":{"type":"string"},"medias":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO","GIF"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}}},"required":["caption","medias"]}}},"required":["accountId","caption","medias"]}},"linkedinTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"visibility":{"default":"PUBLIC","type":"string","enum":["PUBLIC","CONNECTIONS"]},"caption":{"type":"string","maxLength":3000},"documentTitle":{"type":"string","maxLength":200},"firstComment":{"type":"string","maxLength":1250},"captionMentions":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["person","organization"]},"urn":{"type":"string","minLength":1},"displayText":{"type":"string","minLength":1,"maxLength":200},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"imageUrl":{"type":"string","minLength":1}},"required":["type","urn","displayText","start","length"]}},"firstCommentMentions":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["person","organization"]},"urn":{"type":"string","minLength":1},"displayText":{"type":"string","minLength":1,"maxLength":200},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"imageUrl":{"type":"string","minLength":1}},"required":["type","urn","displayText","start","length"]}},"poll":{"type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":140},"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"duration":{"default":"THREE_DAYS","type":"string","enum":["ONE_DAY","THREE_DAYS","SEVEN_DAYS","FOURTEEN_DAYS"]}},"required":["question","options"]},"article":{"type":"object","properties":{"source":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1,"maxLength":400},"description":{"type":"string","maxLength":4086},"thumbnailUrl":{"type":"string","format":"uri"},"thumbnailAltText":{"type":"string","maxLength":120}},"required":["source","title"]},"geoLocations":{"maxItems":150,"type":"array","items":{"type":"object","properties":{"urn":{"type":"string","pattern":"^urn:li:geo:\\d+$"},"displayText":{"type":"string","minLength":1,"maxLength":200}},"required":["urn","displayText"]}},"medias":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"altText":{"type":"string","maxLength":120},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"altText":{"type":"string","maxLength":120},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]},"videoMetadata":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"aspectRatioWidth":{"type":"number"},"aspectRatioHeight":{"type":"number"}}}},"required":["mediaUrl","videoMetadata"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"DOCUMENT"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":200}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}],"type":"object"}},"required":["accountId","caption"]}},"blueskyTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":300},"embed":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"object","properties":{"alt":{"type":"string"},"url":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["url"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"alt":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["url"]}}},"required":["mediaType","medias"]}],"type":"object"}},"required":["accountId","caption"]}},"tiktokTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"privacyLevel":{"type":"string","enum":["PUBLIC","FRIENDS","FOLLOWERS","PRIVATE"]},"disableComment":{"type":"boolean"},"autoAddMusic":{"type":"boolean"},"disableDuet":{"type":"boolean"},"disableStitch":{"type":"boolean"},"commercialContent":{"type":"object","properties":{"isCommercialContent":{"default":false,"type":"boolean"},"yourBrand":{"default":false,"type":"boolean"},"brandedContent":{"default":false,"type":"boolean"}}},"photoCoverIndex":{"type":"integer","minimum":0,"maximum":9007199254740991},"isAigc":{"type":"boolean"},"videoCoverTimestampMs":{"type":"integer","minimum":0,"maximum":9007199254740991},"medias":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":35,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}],"type":"object"},"postMode":{"default":"DIRECT_POST","type":"string","enum":["DIRECT_POST","UPLOAD"]},"title":{"type":"string","maxLength":90},"videoDurationSec":{"type":"number","exclusiveMinimum":0}},"required":["accountId","caption","medias"]}},"mastodonTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":500},"visibility":{"default":"public","type":"string","enum":["public","unlisted","private","direct"]},"sensitive":{"default":false,"type":"boolean"},"spoilerText":{"type":"string"},"language":{"type":"string"},"poll":{"type":"object","properties":{"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":50}},"required":["title"]}},"expiresIn":{"type":"number","minimum":300,"maximum":604800},"multiple":{"default":false,"type":"boolean"},"hideTotals":{"default":false,"type":"boolean"}},"required":["options","expiresIn"]},"medias":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"mediaUrl":{"type":"string"},"size":{"type":"number"},"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"alt":{"type":"string","maxLength":1500},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["name","mediaUrl","size","mediaType"]}}},"required":["accountId","caption","medias"]}},"threadsTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":500},"medias":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}},"userTags":{"type":"array","items":{}},"hashtags":{"type":"array","items":{"type":"string"}},"linkAttachment":{"type":"string","format":"uri"},"topicTag":{"type":"string","minLength":1,"maxLength":50},"poll":{"type":"object","properties":{"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":25}}},"required":["options"]},"segments":{"maxItems":19,"type":"array","items":{"type":"object","properties":{"caption":{"type":"string","maxLength":500},"medias":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}}},"required":["caption","medias"]}}},"required":["accountId","caption","medias"]}},"facebookTargets":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"default":"","type":"string","maxLength":63206},"medias":{"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string"},"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl","mediaType"]}},"isReel":{"default":false,"type":"boolean"},"isSlideshow":{"default":false,"type":"boolean"},"isStory":{"default":false,"type":"boolean"},"slideshowDuration":{"default":1750,"type":"number","minimum":1750,"maximum":10000},"slideshowTransition":{"default":250,"type":"number","minimum":250,"maximum":2000},"coverUrl":{"type":"string"},"location":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["id","name"]}},"required":["accountId","medias"]}}},"required":["scheduledFor","instagramTargets","pinterestTargets","twitterTargets","linkedinTargets","blueskyTargets","tiktokTargets","mastodonTargets","threadsTargets","facebookTargets"]}},"required":["data"]}}}},"responses":{"200":{"description":"Post updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"404":{"description":"Post not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"get":{"operationId":"socialPost.getById","summary":"Get a single post by ID","description":"Returns one draft or scheduled post with all platform targets for editing.","tags":["Posts"],"security":[{"apiKey":[]}],"parameters":[{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string"},"description":"The API key to use for the request"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Post ID"}],"responses":{"200":{"description":"Post fetched successfully","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/posts/{id}/schedule":{"patch":{"operationId":"socialPost-updateSchedule","summary":"Reschedule an existing post","description":"Moves an existing draft or scheduled post to a new future publication date.","tags":["Posts"],"security":[{"apiKey":[]}],"parameters":[{"in":"path","name":"id","schema":{"description":"The post ID returned when the post was created","type":"string"},"required":true,"description":"The post ID returned when the post was created"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"description":"A future ISO 8601 date-time with timezone offset or Z. The worker publishes at this absolute instant.","type":"string"}},"required":["scheduledFor"]}}}},"responses":{"200":{"description":"Post rescheduled successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"404":{"description":"Post not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/instagram/create":{"post":{"operationId":"instagram-create","summary":"Create a new Instagram post","description":"Create a new Instagram post.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"oneOf":[{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"IMAGE"},"mediaUrl":{"type":"string"},"altText":{"type":"string","maxLength":1000},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]},"isStory":{"type":"boolean"}},"required":["accountId","caption","mediaType","mediaUrl"]},{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"VIDEO"},"mediaUrl":{"type":"string"},"coverUrl":{"type":"string"},"thumbOffset":{"type":"integer","minimum":0,"maximum":9007199254740991},"shareToFeed":{"type":"boolean"},"isStory":{"default":false,"type":"boolean"},"isReel":{"default":false,"type":"boolean"}},"required":["accountId","caption","mediaType","mediaUrl"]},{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"location":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["name"]},"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"hashtags":{"type":"array","items":{"type":"string"}},"collaborators":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30}},"required":["username"]}},"firstComment":{"type":"string","maxLength":2200},"isAiGenerated":{"type":"boolean"},"mediaType":{"type":"string","const":"CAROUSEL"},"medias":{"minItems":2,"maxItems":10,"type":"array","items":{"oneOf":[{"type":"object","properties":{"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"altText":{"type":"string","maxLength":1000},"mediaType":{"type":"string","const":"IMAGE"},"mediaUrl":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]},{"type":"object","properties":{"userTags":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username","x","y"]}},"altText":{"type":"string","maxLength":1000},"mediaType":{"type":"string","const":"VIDEO"},"mediaUrl":{"type":"string"},"coverUrl":{"type":"string"}},"required":["mediaType","mediaUrl"]}],"type":"object"}},"isStory":{"type":"boolean"},"isReel":{"type":"boolean"}},"required":["accountId","caption","mediaType","medias","isStory","isReel"]}],"type":"object"}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/bluesky/create":{"post":{"operationId":"bluesky-create","summary":"Create a new Bluesky post","description":"Create a new Bluesky post.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":300},"embed":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"object","properties":{"alt":{"type":"string"},"url":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["url"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"alt":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["url"]}}},"required":["mediaType","medias"]}],"type":"object"}},"required":["accountId","caption"]}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/x/create":{"post":{"operationId":"twitter-create","summary":"Create a new X post","description":"Create a new X post.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string"},"medias":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO","GIF"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}},"segments":{"maxItems":24,"type":"array","items":{"type":"object","properties":{"caption":{"type":"string"},"medias":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO","GIF"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}}},"required":["caption","medias"]}}},"required":["accountId","caption","medias"]}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/linkedin/create":{"post":{"operationId":"linkedin-create","summary":"Create a new LinkedIn post","description":"Create a new LinkedIn post.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"type":"object","properties":{"accountId":{"type":"string"},"visibility":{"default":"PUBLIC","type":"string","enum":["PUBLIC","CONNECTIONS"]},"caption":{"type":"string","maxLength":3000},"documentTitle":{"type":"string","maxLength":200},"firstComment":{"type":"string","maxLength":1250},"captionMentions":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["person","organization"]},"urn":{"type":"string","minLength":1},"displayText":{"type":"string","minLength":1,"maxLength":200},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"imageUrl":{"type":"string","minLength":1}},"required":["type","urn","displayText","start","length"]}},"firstCommentMentions":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["person","organization"]},"urn":{"type":"string","minLength":1},"displayText":{"type":"string","minLength":1,"maxLength":200},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"imageUrl":{"type":"string","minLength":1}},"required":["type","urn","displayText","start","length"]}},"poll":{"type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":140},"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"duration":{"default":"THREE_DAYS","type":"string","enum":["ONE_DAY","THREE_DAYS","SEVEN_DAYS","FOURTEEN_DAYS"]}},"required":["question","options"]},"article":{"type":"object","properties":{"source":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1,"maxLength":400},"description":{"type":"string","maxLength":4086},"thumbnailUrl":{"type":"string","format":"uri"},"thumbnailAltText":{"type":"string","maxLength":120}},"required":["source","title"]},"geoLocations":{"maxItems":150,"type":"array","items":{"type":"object","properties":{"urn":{"type":"string","pattern":"^urn:li:geo:\\d+$"},"displayText":{"type":"string","minLength":1,"maxLength":200}},"required":["urn","displayText"]}},"medias":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"altText":{"type":"string","maxLength":120},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"altText":{"type":"string","maxLength":120},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]},"videoMetadata":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"aspectRatioWidth":{"type":"number"},"aspectRatioHeight":{"type":"number"}}}},"required":["mediaUrl","videoMetadata"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"DOCUMENT"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":200}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}],"type":"object"}},"required":["accountId","caption"]}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/pinterest/boards/{accountId}":{"get":{"operationId":"pinterest-getBoards","summary":"Get all Pinterest boards for an account","description":"Returns all Pinterest boards for the given account.","tags":["Pinterest"],"security":[{"apiKey":[]}],"parameters":[{"in":"path","name":"accountId","schema":{"description":"The Pinterest account ID from list_connected_accounts","type":"string"},"required":true,"description":"The Pinterest account ID from list_connected_accounts"}],"responses":{"200":{"description":"Boards fetched successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"board_pins_modified_at":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"collaborator_count":{"type":"number"},"pin_count":{"type":"number"},"follower_count":{"type":"number"},"media":{"type":"object","properties":{"pin_thumbnail_urls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"owner":{"type":"object","properties":{"username":{"type":"string"}},"additionalProperties":false},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"]},"sections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}},"required":["id","created_at","name","collaborator_count","pin_count","follower_count","owner","privacy","sections"],"additionalProperties":false}}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"404":{"description":"Post not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}},"post":{"operationId":"pinterest-createBoard","summary":"Create a Pinterest board","description":"Creates a new Pinterest board for the given account.","tags":["Pinterest"],"security":[{"apiKey":[]}],"parameters":[{"in":"path","name":"accountId","schema":{"description":"The Pinterest account ID from list_connected_accounts","type":"string"},"required":true,"description":"The Pinterest account ID from list_connected_accounts"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"description":"The board name","type":"string"},"description":{"description":"Optional board description","type":"string"},"privacy":{"description":"Optional board visibility","type":"string","enum":["PUBLIC","SECRET"]}},"required":["name"]}}}},"responses":{"200":{"description":"Board created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"board_pins_modified_at":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"collaborator_count":{"type":"number"},"pin_count":{"type":"number"},"follower_count":{"type":"number"},"media":{"type":"object","properties":{"pin_thumbnail_urls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"owner":{"type":"object","properties":{"username":{"type":"string"}},"additionalProperties":false},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"]}},"required":["id","created_at","name","collaborator_count","pin_count","follower_count","owner","privacy"],"additionalProperties":false}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"404":{"description":"Post not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/pinterest/boards/{accountId}/{boardId}":{"get":{"operationId":"pinterest-getBoard","summary":"Get a Pinterest board by ID","description":"Returns a single Pinterest board for the given account and board ID.","tags":["Pinterest"],"security":[{"apiKey":[]}],"parameters":[{"in":"path","name":"accountId","schema":{"type":"string"},"required":true},{"in":"path","name":"boardId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Board fetched successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"board_pins_modified_at":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"collaborator_count":{"type":"number"},"pin_count":{"type":"number"},"follower_count":{"type":"number"},"media":{"type":"object","properties":{"pin_thumbnail_urls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"owner":{"type":"object","properties":{"username":{"type":"string"}},"additionalProperties":false},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"]}},"required":["id","created_at","name","collaborator_count","pin_count","follower_count","owner","privacy"],"additionalProperties":false}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"404":{"description":"Post not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.NOT_FOUND"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/pinterest/create":{"post":{"operationId":"pinterest-create","summary":"Create a new Pinterest post","description":"Create a new Pinterest post.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"oneOf":[{"type":"object","properties":{"accountId":{"type":"string"},"boardId":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":800},"altText":{"type":"string","maxLength":500},"link":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"string","const":""}]},"dominantColor":{"type":"string"},"boardSectionId":{"type":"string"},"isStandard":{"type":"boolean"},"mediaType":{"type":"string","const":"IMAGE"},"medias":{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}},"required":["accountId","boardId","mediaType","medias"]},{"type":"object","properties":{"accountId":{"type":"string"},"boardId":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":800},"altText":{"type":"string","maxLength":500},"link":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"string","const":""}]},"dominantColor":{"type":"string"},"boardSectionId":{"type":"string"},"isStandard":{"type":"boolean"},"mediaType":{"type":"string","const":"VIDEO"},"medias":{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"coverImageUrl":{"type":"string","format":"uri"},"coverImageContentType":{"type":"string"},"coverImageKeyFrameTime":{"type":"number"}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}},"required":["accountId","boardId","mediaType","medias"]}],"type":"object"}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/tiktok/create":{"post":{"operationId":"tiktok-create","summary":"Create a TikTok post","description":"Create a TikTok post. postMode DIRECT_POST publishes to the profile when the schedule runs (privacyLevel required from GET /tiktok/creator-info/{accountId}). postMode UPLOAD sends media as a draft to the creator TikTok inbox; they finish in the TikTok app. Inbox UPLOAD does not send privacy or interaction settings.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":2200},"privacyLevel":{"type":"string","enum":["PUBLIC","FRIENDS","FOLLOWERS","PRIVATE"]},"disableComment":{"type":"boolean"},"autoAddMusic":{"type":"boolean"},"disableDuet":{"type":"boolean"},"disableStitch":{"type":"boolean"},"commercialContent":{"type":"object","properties":{"isCommercialContent":{"default":false,"type":"boolean"},"yourBrand":{"default":false,"type":"boolean"},"brandedContent":{"default":false,"type":"boolean"}}},"photoCoverIndex":{"type":"integer","minimum":0,"maximum":9007199254740991},"isAigc":{"type":"boolean"},"videoCoverTimestampMs":{"type":"integer","minimum":0,"maximum":9007199254740991},"medias":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"medias":{"minItems":1,"maxItems":35,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"medias":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string","format":"uri"}},"required":["mediaUrl"]}}},"required":["mediaType","medias"]}],"type":"object"},"postMode":{"default":"DIRECT_POST","type":"string","enum":["DIRECT_POST","UPLOAD"]},"title":{"type":"string","maxLength":90},"videoDurationSec":{"type":"number","exclusiveMinimum":0}},"required":["accountId","caption","medias"]}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"TikTok post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/tiktok/creator-info/{accountId}":{"get":{"operationId":"tiktok-getCreatorInfo","summary":"Get TikTok creator info for posting UI","description":"Returns creator nickname, avatar, allowed privacy levels, interaction settings, max video duration, and posting limits. Call before building a TikTok post payload.","tags":["TikTok"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"},{"in":"path","name":"accountId","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Creator info fetched successfully","content":{"application/json":{"schema":{"type":"object","properties":{"open_id":{"type":"string"},"username":{"type":"string"},"display_name":{"type":"string"},"avatar_url":{"type":"string"},"privacy_level_options":{"type":"array","items":{"type":"string","enum":["PUBLIC","FRIENDS","FOLLOWERS","PRIVATE"]}},"max_video_post_duration_sec":{"type":"number"},"interaction_settings":{"type":"object","properties":{"comment_disabled":{"type":"boolean"},"duet_disabled":{"type":"boolean"},"stitch_disabled":{"type":"boolean"}},"required":["comment_disabled","duet_disabled","stitch_disabled"],"additionalProperties":false},"posting_limits":{"type":"object","properties":{"can_post":{"type":"boolean"},"daily_quota_total":{"type":"number"},"daily_quota_used":{"type":"number"},"next_available_time":{"type":"string"}},"required":["can_post","daily_quota_total","daily_quota_used"],"additionalProperties":false}},"required":["open_id","username","display_name","avatar_url","privacy_level_options","max_video_post_duration_sec","interaction_settings","posting_limits"],"additionalProperties":false}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/tiktok/posts-with-analytics/{accountId}":{"get":{"operationId":"tiktok-getPostsWithAnalytics","summary":"List public TikTok videos with engagement metrics","description":"Returns recent public videos for a connected TikTok account via video.list, including view/like/comment/share counts.","tags":["TikTok","Analytics"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"},{"in":"path","name":"accountId","schema":{"type":"string"},"required":true},{"in":"query","name":"limit","schema":{"default":20,"type":"number","minimum":1,"maximum":50}},{"in":"query","name":"startDate","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"endDate","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Videos with analytics fetched successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"create_time":{"type":"number"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"video_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"number"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"like_count":{"type":"number"},"comment_count":{"type":"number"},"share_count":{"type":"number"},"view_count":{"type":"number"},"engagements":{"type":"number"},"publishedAt":{"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))$"},{"type":"null"}]},"performanceRank":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"viewsDelta":{"anyOf":[{"type":"number"},{"type":"null"}]},"viewsGrowthRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"historicalData":{"default":[],"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"timestamp":{"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))$"},{"type":"string"}]},"views":{"type":"number"},"likes":{"type":"number"},"comments":{"type":"number"},"shares":{"type":"number"},"engagements":{"type":"number"}},"required":["index","timestamp","views","likes","comments","shares","engagements"],"additionalProperties":false}}},"required":["id","create_time","like_count","comment_count","share_count","view_count","engagements","publishedAt","historicalData"],"additionalProperties":false}}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/mastodon/create":{"post":{"operationId":"mastodon-create","summary":"Create a new Mastodon post","description":"Create a new Mastodon post.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":500},"visibility":{"default":"public","type":"string","enum":["public","unlisted","private","direct"]},"sensitive":{"default":false,"type":"boolean"},"spoilerText":{"type":"string"},"language":{"type":"string"},"poll":{"type":"object","properties":{"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":50}},"required":["title"]}},"expiresIn":{"type":"number","minimum":300,"maximum":604800},"multiple":{"default":false,"type":"boolean"},"hideTotals":{"default":false,"type":"boolean"}},"required":["options","expiresIn"]},"medias":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"mediaUrl":{"type":"string"},"size":{"type":"number"},"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"alt":{"type":"string","maxLength":1500},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["name","mediaUrl","size","mediaType"]}}},"required":["accountId","caption","medias"]}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/threads/create":{"post":{"operationId":"threads-create","summary":"Create a new Threads post","description":"Create a new Threads post.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"type":"string","maxLength":500},"medias":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}},"userTags":{"type":"array","items":{}},"hashtags":{"type":"array","items":{"type":"string"}},"linkAttachment":{"type":"string","format":"uri"},"topicTag":{"type":"string","minLength":1,"maxLength":50},"poll":{"type":"object","properties":{"options":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":25}}},"required":["options"]},"segments":{"maxItems":19,"type":"array","items":{"type":"object","properties":{"caption":{"type":"string","maxLength":500},"medias":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"mediaUrl":{"type":"string"},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaType","mediaUrl"]}}},"required":["caption","medias"]}}},"required":["accountId","caption","medias"]}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/facebook/create":{"post":{"operationId":"facebook-create","summary":"Create a new Facebook post","description":"Create a new Facebook post.","tags":["Schedulers"],"security":[{"apiKey":[]}],"parameters":[{"in":"header","name":"x-api-key","schema":{"description":"The API key to use for the request","type":"string"},"required":true,"description":"The API key to use for the request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduledFor":{"oneOf":[{"type":"object","properties":{"publish":{"type":"string","const":"DRAFT"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"NOW"}},"required":["publish"]},{"type":"object","properties":{"publish":{"type":"string","const":"SCHEDULE"},"date":{"anyOf":[{"type":"string"},{"type":"string"}]}},"required":["publish","date"]}],"type":"object"},"post":{"type":"object","properties":{"accountId":{"type":"string"},"caption":{"default":"","type":"string","maxLength":63206},"medias":{"type":"array","items":{"type":"object","properties":{"mediaUrl":{"type":"string"},"mediaType":{"type":"string","enum":["IMAGE","VIDEO"]},"altText":{"type":"string"},"transform":{"type":"object","properties":{"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"]},"aspect":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit":{"type":"string","enum":["cover","contain"]},"userEdited":{"type":"boolean"}},"required":["crop","aspect","width","height","fit","userEdited"]}},"required":["mediaUrl","mediaType"]}},"isReel":{"default":false,"type":"boolean"},"isSlideshow":{"default":false,"type":"boolean"},"isStory":{"default":false,"type":"boolean"},"slideshowDuration":{"default":1750,"type":"number","minimum":1750,"maximum":10000},"slideshowTransition":{"default":250,"type":"number","minimum":250,"maximum":2000},"coverUrl":{"type":"string"},"location":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["id","name"]}},"required":["accountId","medias"]}},"required":["scheduledFor","post"]}}}},"responses":{"200":{"description":"Post created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"403":{"description":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.FORBIDDEN"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/media/upload-url":{"post":{"operationId":"media-getUploadUrl","summary":"Get presigned URL for media upload","description":"Get a presigned URL to upload media files to storage. Returns upload URL and permanent file URL.","tags":["Media"],"security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filename":{"description":"The original filename including extension","type":"string"},"contentType":{"description":"The MIME type that will be uploaded","type":"string"}},"required":["filename","contentType"]}}}},"responses":{"200":{"description":"Upload URL generated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"presignedUrl":{"description":"The presigned URL for the media","type":"string"},"key":{"description":"The storage key for the uploaded media","type":"string"},"url":{"description":"The public URL for the uploaded media","type":"string"},"uploadMethod":{"description":"The HTTP method used for upload","type":"string","const":"PUT"},"contentType":{"description":"The MIME type that should be used for the upload","type":"string"}},"required":["presignedUrl","key","url","uploadMethod","contentType"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/media/from-url":{"post":{"operationId":"media-uploadFromUrl","summary":"Ingest media from a public URL","description":"Fallback when the caller cannot PUT to a presigned URL. SocialRobot fetches a public image/video URL (or a ChatGPT file download_url) and stores it. Prefer POST /media/upload-url plus PUT when the client can upload itself. Max 50MB.","tags":["Media"],"security":[{"apiKey":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceUrl":{"description":"Public https URL of an image or video. Use only when you cannot PUT to the presigned URL from get_media_upload_url.","type":"string"},"file":{"description":"ChatGPT connector file. ChatGPT fills this when the tool declares openai/fileParams. Prefer get_media_upload_url + PUT when you can reach the storage host.","anyOf":[{"type":"object","properties":{"download_url":{"description":"Temporary ChatGPT download URL for the file","type":"string"},"file_id":{"description":"Stable ChatGPT file id","type":"string"},"mime_type":{"description":"MIME type when ChatGPT provides one","type":"string"},"file_name":{"description":"Original filename when ChatGPT provides one","type":"string"}},"required":["download_url","file_id"]},{"minItems":1,"type":"array","items":{"type":"object","properties":{"download_url":{"description":"Temporary ChatGPT download URL for the file","type":"string"},"file_id":{"description":"Stable ChatGPT file id","type":"string"},"mime_type":{"description":"MIME type when ChatGPT provides one","type":"string"},"file_name":{"description":"Original filename when ChatGPT provides one","type":"string"}},"required":["download_url","file_id"]}}]},"filename":{"description":"Original filename including extension, if the source URL has none","type":"string"},"contentType":{"description":"MIME type hint when the source does not send one","type":"string"}}}}}},"responses":{"200":{"description":"Media stored successfully","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"description":"The storage key for the uploaded media","type":"string"},"url":{"description":"The public URL to pass into create_post","type":"string"},"contentType":{"description":"The stored MIME type","type":"string"}},"required":["key","url","contentType"],"additionalProperties":false}}}},"400":{"description":"Invalid request data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.BAD_REQUEST"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}},"/accounts":{"get":{"operationId":"accounts-listConnected","summary":"List all connected social accounts","description":"Returns the connected social accounts available to the authenticated user across every supported platform.","tags":["Accounts"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Connected accounts fetched successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Internal account ID used by the API","type":"string"},"platform":{"description":"The connected social platform","type":"string","enum":["instagram","pinterest","x","linkedin","bluesky","tiktok","mastodon","threads","facebook"]},"handle":{"description":"Platform handle, username, or page identifier","anyOf":[{"type":"string"},{"type":"null"}]},"displayName":{"description":"Human-readable account or page name","anyOf":[{"type":"string"},{"type":"null"}]},"profileImage":{"description":"Profile image or avatar URL when available","anyOf":[{"type":"string"},{"type":"null"}]},"externalAccountId":{"description":"Platform-native account identifier","anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"description":"Token expiration date when the integration tracks one","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","platform","handle","displayName","profileImage","externalAccountId","expiresAt"],"additionalProperties":false}}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.UNAUTHORIZED"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error.INTERNAL_SERVER_ERROR"}}}}}}}},"components":{"schemas":{"error.BAD_REQUEST":{"title":"Invalid request data error (400)","description":"The error information","example":{"code":"BAD_REQUEST","message":"Invalid request data","issues":[]},"type":"object","properties":{"message":{"description":"The error message","example":"Invalid request data","type":"string"},"code":{"description":"The error code","example":"BAD_REQUEST","type":"string"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false},"error.UNAUTHORIZED":{"title":"Unauthorized - Invalid or missing API key error (401)","description":"The error information","example":{"code":"UNAUTHORIZED","message":"Unauthorized - Invalid or missing API key","issues":[]},"type":"object","properties":{"message":{"description":"The error message","example":"Unauthorized - Invalid or missing API key","type":"string"},"code":{"description":"The error code","example":"UNAUTHORIZED","type":"string"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false},"error.FORBIDDEN":{"title":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link) error (403)","description":"The error information","example":{"code":"FORBIDDEN","message":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","issues":[]},"type":"object","properties":{"message":{"description":"The error message","example":"Forbidden - plan limit, ownership, or quota exceeded (see error message for upgrade link)","type":"string"},"code":{"description":"The error code","example":"FORBIDDEN","type":"string"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false},"error.TOO_MANY_REQUESTS":{"title":"Too many requests - daily API quota exceeded error (429)","description":"The error information","example":{"code":"TOO_MANY_REQUESTS","message":"Too many requests - daily API quota exceeded","issues":[]},"type":"object","properties":{"message":{"description":"The error message","example":"Too many requests - daily API quota exceeded","type":"string"},"code":{"description":"The error code","example":"TOO_MANY_REQUESTS","type":"string"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false},"error.INTERNAL_SERVER_ERROR":{"title":"Internal server error error (500)","description":"The error information","example":{"code":"INTERNAL_SERVER_ERROR","message":"Internal server error","issues":[]},"type":"object","properties":{"message":{"description":"The error message","example":"Internal server error","type":"string"},"code":{"description":"The error code","example":"INTERNAL_SERVER_ERROR","type":"string"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false},"error.NOT_FOUND":{"title":"Post not found error (404)","description":"The error information","example":{"code":"NOT_FOUND","message":"Post not found","issues":[]},"type":"object","properties":{"message":{"description":"The error message","example":"Post not found","type":"string"},"code":{"description":"The error code","example":"NOT_FOUND","type":"string"},"issues":{"description":"An array of issues that were responsible for the error","example":[],"type":"array","items":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}},"required":["message","code"],"additionalProperties":false}},"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"API Key authentication"}}}}