{"openapi":"3.1.0","info":{"title":"Postmaxx API","version":"1.0.0","description":"Schedule posts to every account from one calendar. Every endpoint of the web app, for agents and scripts: authenticate with an API key from Integrations › Your agent (Authorization: Bearer pmx_…). Times are UTC with milliseconds; wall times are in the workspace zone. Errors share one shape."},"servers":[{"url":"https://postmaxx.io/api/v1"}],"security":[{"apiKey":[]}],"tags":[{"name":"Me"},{"name":"Workspaces"},{"name":"Members"},{"name":"Accounts"},{"name":"Posting times"},{"name":"Media"},{"name":"Posts"},{"name":"Analytics"},{"name":"Billing"},{"name":"API keys"},{"name":"Meta"},{"name":"Apps"},{"name":"Integrations"},{"name":"CLI"}],"paths":{"/me":{"get":{"operationId":"getMe","tags":["Me"],"summary":"The signed-in person and their workspaces.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"image":{"type":["string","null"]},"activeWorkspaceId":{"type":["string","null"]},"workspaces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]}},"required":["id","name","role"],"additionalProperties":false}}},"required":["id","name","email","image","activeWorkspaceId","workspaces"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"patchMe","tags":["Me"],"summary":"Change your name.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"image":{"type":["string","null"]},"activeWorkspaceId":{"type":["string","null"]},"workspaces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]}},"required":["id","name","role"],"additionalProperties":false}}},"required":["id","name","email","image","activeWorkspaceId","workspaces"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"required":["name"],"additionalProperties":false}}}}},"delete":{"operationId":"deleteMe","tags":["Me"],"summary":"Delete your account.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"204":{"description":"Done."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirmEmail":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["confirmEmail"],"additionalProperties":false}}}}}},"/me/notifications":{"get":{"operationId":"getMeNotifications","tags":["Me"],"summary":"Your email choices for this workspace.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"emailFailures":{"type":"boolean"},"emailReconnect":{"type":"boolean"}},"required":["emailFailures","emailReconnect"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"putMeNotifications","tags":["Me"],"summary":"Change your email choices.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"emailFailures":{"type":"boolean"},"emailReconnect":{"type":"boolean"}},"required":["emailFailures","emailReconnect"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"emailFailures":{"type":"boolean"},"emailReconnect":{"type":"boolean"}},"required":["emailFailures","emailReconnect"],"additionalProperties":false}}}}}},"/me/sign-out-others":{"post":{"operationId":"postMeSignOutOthers","tags":["Me"],"summary":"Sign out of other devices, the Postmaxx CLI included.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"sessionsRevoked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cliKeysRevoked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["sessionsRevoked","cliKeysRevoked"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"preview","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}]}},"/workspaces":{"get":{"operationId":"getWorkspaces","tags":["Workspaces"],"summary":"Your workspaces.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["owner","admin","member"]},{"type":"null"}]},"timezone":{"type":"string"},"weekStart":{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},"timeFormat":{"type":"string","enum":["24h","12h"]},"createdAt":{"type":"string"}},"required":["id","name","role","timezone","weekStart","timeFormat","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"postWorkspaces","tags":["Workspaces"],"summary":"Create a workspace (with its first app).","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["owner","admin","member"]},{"type":"null"}]},"timezone":{"type":"string"},"weekStart":{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},"timeFormat":{"type":"string","enum":["24h","12h"]},"createdAt":{"type":"string"}},"required":["id","name","role","timezone","weekStart","timeFormat","createdAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"timezone":{"type":"string","maxLength":64},"appName":{"type":"string","minLength":1,"maxLength":60}},"required":["name","timezone"],"additionalProperties":false}}}}}},"/workspaces/{id}/activate":{"post":{"operationId":"postWorkspacesByIdActivate","tags":["Workspaces"],"summary":"Make a workspace the active one.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["owner","admin","member"]},{"type":"null"}]},"timezone":{"type":"string"},"weekStart":{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},"timeFormat":{"type":"string","enum":["24h","12h"]},"createdAt":{"type":"string"}},"required":["id","name","role","timezone","weekStart","timeFormat","createdAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/workspace":{"get":{"operationId":"getWorkspace","tags":["Workspaces"],"summary":"The workspace this call works in.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["owner","admin","member"]},{"type":"null"}]},"timezone":{"type":"string"},"weekStart":{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},"timeFormat":{"type":"string","enum":["24h","12h"]},"createdAt":{"type":"string"}},"required":["id","name","role","timezone","weekStart","timeFormat","createdAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"patchWorkspace","tags":["Workspaces"],"summary":"Change the workspace settings.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["owner","admin","member"]},{"type":"null"}]},"timezone":{"type":"string"},"weekStart":{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},"timeFormat":{"type":"string","enum":["24h","12h"]},"createdAt":{"type":"string"}},"required":["id","name","role","timezone","weekStart","timeFormat","createdAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"timezone":{"type":"string","maxLength":64},"weekStart":{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},"timeFormat":{"type":"string","enum":["24h","12h"]}},"additionalProperties":false}}}}},"delete":{"operationId":"deleteWorkspace","tags":["Workspaces"],"summary":"Delete the workspace.","description":"The workspace owner, signed in.","security":[{"session":[]}],"responses":{"204":{"description":"Done."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirmName":{"type":"string","minLength":1,"maxLength":100}},"required":["confirmName"],"additionalProperties":false}}}}}},"/workspace/transfer":{"post":{"operationId":"postWorkspaceTransfer","tags":["Workspaces"],"summary":"Transfer ownership to an admin.","description":"The workspace owner, signed in.","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]},"joinedAt":{"type":"string"},"lastActiveAt":{"type":["string","null"]}},"required":["userId","name","email","role","joinedAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"required":["userId"],"additionalProperties":false}}}}}},"/members":{"get":{"operationId":"getMembers","tags":["Members"],"summary":"The members of the workspace.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]},"joinedAt":{"type":"string"},"lastActiveAt":{"type":["string","null"]}},"required":["userId","name","email","role","joinedAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/members/{userId}":{"patch":{"operationId":"patchMembersByUserId","tags":["Members"],"summary":"Change a member's role.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]},"joinedAt":{"type":"string"},"lastActiveAt":{"type":["string","null"]}},"required":["userId","name","email","role","joinedAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string","enum":["admin","member"]}},"required":["role"],"additionalProperties":false}}}}},"delete":{"operationId":"deleteMembersByUserId","tags":["Members"],"summary":"Remove a member (their API keys stop working).","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"revokedApiKeys":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["revokedApiKeys"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string"}},{"name":"preview","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}]}},"/invitations":{"get":{"operationId":"getInvitations","tags":["Members"],"summary":"Pending invitations.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["admin","member"]},"status":{"type":"string","enum":["pending","expired","accepted"]},"invitedBy":{"type":"string"},"expiresAt":{"type":"string"},"link":{"type":"string"},"emailSent":{"type":"boolean"}},"required":["id","email","role","status","invitedBy","expiresAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"postInvitations","tags":["Members"],"summary":"Invite someone.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["admin","member"]},"status":{"type":"string","enum":["pending","expired","accepted"]},"invitedBy":{"type":"string"},"expiresAt":{"type":"string"},"link":{"type":"string"},"emailSent":{"type":"boolean"}},"required":["id","email","role","status","invitedBy","expiresAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["member","admin"]}},"required":["email","role"],"additionalProperties":false}}}}}},"/invitations/{id}/resend":{"post":{"operationId":"postInvitationsByIdResend","tags":["Members"],"summary":"Send an invitation again.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["admin","member"]},"status":{"type":"string","enum":["pending","expired","accepted"]},"invitedBy":{"type":"string"},"expiresAt":{"type":"string"},"link":{"type":"string"},"emailSent":{"type":"boolean"}},"required":["id","email","role","status","invitedBy","expiresAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/invitations/{id}":{"delete":{"operationId":"deleteInvitationsById","tags":["Members"],"summary":"Cancel an invitation.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"204":{"description":"Done."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/invitations/{id}/public":{"get":{"operationId":"getInvitationsByIdPublic","tags":["Members"],"summary":"What an invitation link shows.","description":"Anyone (no sign-in).","security":[],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceName":{"type":"string"},"invitedBy":{"type":"string"},"email":{"type":"string"},"status":{"type":"string","enum":["pending","expired","accepted"]}},"required":["workspaceName","invitedBy","email","status"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/invitations/{id}/accept":{"post":{"operationId":"postInvitationsByIdAccept","tags":["Members"],"summary":"Accept an invitation.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["owner","admin","member"]},{"type":"null"}]},"timezone":{"type":"string"},"weekStart":{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},"timeFormat":{"type":"string","enum":["24h","12h"]},"createdAt":{"type":"string"}},"required":["id","name","role","timezone","weekStart","timeFormat","createdAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/providers":{"get":{"operationId":"getProviders","tags":["Accounts"],"summary":"Every platform and whether it can be connected here.","description":"Anyone (no sign-in).","security":[],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"name":{"type":"string"},"enabled":{"type":"boolean"},"comingSoon":{"type":"boolean"},"connectMethod":{"type":"string","enum":["instant","oauth","instance_oauth","app_password"]},"countsTowardLimit":{"type":"boolean"},"canDelete":{"type":"boolean"}},"required":["id","name","enabled","comingSoon","connectMethod","countsTowardLimit","canDelete"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/providers/{id}/options":{"get":{"operationId":"getProvidersByIdOptions","tags":["Accounts"],"summary":"A platform's per-account post settings and their defaults.","description":"Anyone (no sign-in).","security":[],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"defaults":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["provider","schema","defaults"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/accounts":{"get":{"operationId":"getAccounts","tags":["Accounts"],"summary":"Connected accounts.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"appId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]},"statusReason":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"isTest":{"type":"boolean"},"testBehavior":{"anyOf":[{"type":"string","enum":["ok","fail_once","busy_once","unclear_found_once","unclear_lost_once","signed_out","slow_once"]},{"type":"null"}]},"limits":{"type":"object","properties":{"maxCharacters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxMedia":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maxCharacters","maxMedia"],"additionalProperties":false},"createdAt":{"type":"string"},"removedAt":{"type":["string","null"]}},"required":["id","appId","provider","handle","displayName","avatarUrl","status","statusReason","expiresAt","isTest","testBehavior","limits","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"includeRemoved","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}},{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}}]}},"/accounts/{id}/options":{"get":{"operationId":"getAccountsByIdOptions","tags":["Accounts"],"summary":"An account's post settings, with live choices from the platform.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"defaults":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"accountId":{"type":"string"},"live":{"anyOf":[{"type":"object","properties":{"facts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","boolean","null"]}},"choices":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"value":{"type":["string","number","boolean"]},"label":{"type":"string"}},"required":["value","label"],"additionalProperties":false}}},"disabled":{"type":"array","items":{"type":"string"}}},"required":["facts","choices","disabled"],"additionalProperties":false},{"type":"null"}]},"liveError":{"type":["string","null"]}},"required":["provider","schema","defaults","accountId","live","liveError"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/accounts/connect":{"post":{"operationId":"postAccountsConnect","tags":["Accounts"],"summary":"Connect an account.","description":"Admins and the owner, signed in (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"connected"},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"appId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]},"statusReason":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"isTest":{"type":"boolean"},"testBehavior":{"anyOf":[{"type":"string","enum":["ok","fail_once","busy_once","unclear_found_once","unclear_lost_once","signed_out","slow_once"]},{"type":"null"}]},"limits":{"type":"object","properties":{"maxCharacters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxMedia":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maxCharacters","maxMedia"],"additionalProperties":false},"createdAt":{"type":"string"},"removedAt":{"type":["string","null"]}},"required":["id","appId","provider","handle","displayName","avatarUrl","status","statusReason","expiresAt","isTest","testBehavior","limits","createdAt"],"additionalProperties":false}}},"required":["kind","accounts"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"redirect"},"url":{"type":"string"}},"required":["kind","url"],"additionalProperties":false}]}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"provider":{"type":"string","const":"test"},"appId":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"},"returnTo":{"type":"string","minLength":1,"maxLength":2048,"format":"starts_with","pattern":"^\\/.*"}},"required":["provider"],"additionalProperties":false},{"type":"object","properties":{"provider":{"type":"string","const":"bluesky"},"handle":{"type":"string","minLength":1,"maxLength":253},"appPassword":{"type":"string","minLength":1,"maxLength":100},"appId":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"},"returnTo":{"type":"string","minLength":1,"maxLength":2048,"format":"starts_with","pattern":"^\\/.*"}},"required":["provider","handle","appPassword"],"additionalProperties":false},{"type":"object","properties":{"provider":{"type":"string","const":"mastodon"},"instance":{"type":"string","minLength":1,"maxLength":253},"appId":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"},"returnTo":{"type":"string","minLength":1,"maxLength":2048,"format":"starts_with","pattern":"^\\/.*"}},"required":["provider","instance"],"additionalProperties":false},{"type":"object","properties":{"provider":{"type":"string","enum":["x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"appId":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"},"returnTo":{"type":"string","minLength":1,"maxLength":2048,"format":"starts_with","pattern":"^\\/.*"}},"required":["provider"],"additionalProperties":false}]}}}}}},"/oauth/{provider}/callback":{"get":{"operationId":"getOauthByProviderCallback","tags":["Accounts"],"summary":"Where a platform sends the browser back after sign-in.","description":"The browser, coming back from the platform.","security":[{"session":[]}],"responses":{"302":{"description":"A redirect back into the app."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}]}},"/accounts/{id}/reconnect":{"post":{"operationId":"postAccountsByIdReconnect","tags":["Accounts"],"summary":"Reconnect an account.","description":"Admins and the owner, signed in (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"connected"},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"appId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]},"statusReason":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"isTest":{"type":"boolean"},"testBehavior":{"anyOf":[{"type":"string","enum":["ok","fail_once","busy_once","unclear_found_once","unclear_lost_once","signed_out","slow_once"]},{"type":"null"}]},"limits":{"type":"object","properties":{"maxCharacters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxMedia":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maxCharacters","maxMedia"],"additionalProperties":false},"createdAt":{"type":"string"},"removedAt":{"type":["string","null"]}},"required":["id","appId","provider","handle","displayName","avatarUrl","status","statusReason","expiresAt","isTest","testBehavior","limits","createdAt"],"additionalProperties":false}}},"required":["kind","accounts"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"redirect"},"url":{"type":"string"}},"required":["kind","url"],"additionalProperties":false}]}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appPassword":{"type":"string","minLength":1,"maxLength":100},"returnTo":{"type":"string","minLength":1,"maxLength":2048,"format":"starts_with","pattern":"^\\/.*"}},"additionalProperties":false}}}}}},"/accounts/{id}":{"patch":{"operationId":"patchAccountsById","tags":["Accounts"],"summary":"Set a Test channel's next result.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"appId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]},"statusReason":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"isTest":{"type":"boolean"},"testBehavior":{"anyOf":[{"type":"string","enum":["ok","fail_once","busy_once","unclear_found_once","unclear_lost_once","signed_out","slow_once"]},{"type":"null"}]},"limits":{"type":"object","properties":{"maxCharacters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxMedia":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maxCharacters","maxMedia"],"additionalProperties":false},"createdAt":{"type":"string"},"removedAt":{"type":["string","null"]}},"required":["id","appId","provider","handle","displayName","avatarUrl","status","statusReason","expiresAt","isTest","testBehavior","limits","createdAt"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"testBehavior":{"type":"string","enum":["ok","fail_once","busy_once","unclear_found_once","unclear_lost_once","signed_out","slow_once"]}},"required":["testBehavior"],"additionalProperties":false}}}}},"delete":{"operationId":"deleteAccountsById","tags":["Accounts"],"summary":"Remove an account.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"scheduledPosts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"postsMovedToDraft":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["scheduledPosts","postsMovedToDraft"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"preview","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}]}},"/accounts/select-active":{"post":{"operationId":"postAccountsSelectActive","tags":["Accounts"],"summary":"Choose which accounts stay active within the plan's limit.","description":"The workspace owner, signed in.","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"appId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]},"statusReason":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"isTest":{"type":"boolean"},"testBehavior":{"anyOf":[{"type":"string","enum":["ok","fail_once","busy_once","unclear_found_once","unclear_lost_once","signed_out","slow_once"]},{"type":"null"}]},"limits":{"type":"object","properties":{"maxCharacters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxMedia":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maxCharacters","maxMedia"],"additionalProperties":false},"createdAt":{"type":"string"},"removedAt":{"type":["string","null"]}},"required":["id","appId","provider","handle","displayName","avatarUrl","status","statusReason","expiresAt","isTest","testBehavior","limits","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountIds":{"maxItems":50,"type":"array","items":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"}}},"required":["accountIds"],"additionalProperties":false}}}}}},"/posting-times":{"get":{"operationId":"getPostingTimes","tags":["Posting times"],"summary":"The queue: weekly posting times.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"weekday":{"type":"integer","minimum":0,"maximum":6},"time":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["id","weekday","time"],"additionalProperties":false}}},"required":["timezone","data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"putPostingTimes","tags":["Posting times"],"summary":"Replace every posting time.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"weekday":{"type":"integer","minimum":0,"maximum":6},"time":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["id","weekday","time"],"additionalProperties":false}}},"required":["timezone","data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slots":{"maxItems":70,"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6},"time":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["weekday","time"],"additionalProperties":false}}},"required":["slots"],"additionalProperties":false}}}}}},"/posting-times/next":{"get":{"operationId":"getPostingTimesNext","tags":["Posting times"],"summary":"The next free posting times.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"local":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"}},"required":["at","local"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"accountIds","in":"query","required":false,"schema":{"type":"string","maxLength":1696}},{"name":"count","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":50}}]}},"/media":{"post":{"operationId":"postMedia","tags":["Media"],"summary":"Start an upload (reserves storage).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false},"upload":{"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"single"},"url":{"type":"string"}},"required":["mode","url"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"multipart"},"partSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"partCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"partUrl":{"type":"string"},"completeUrl":{"type":"string"}},"required":["mode","partSize","partCount","partUrl","completeUrl"],"additionalProperties":false}]}},"required":["media","upload"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","minLength":1,"maxLength":255},"mime":{"type":"string","minLength":3,"maxLength":100},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string","maxLength":1000}},"required":["fileName","mime","bytes"],"additionalProperties":false}}}}},"get":{"operationId":"getMedia","tags":["Media"],"summary":"The media library, newest first.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["data","nextCursor"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["image","gif","video"]}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000}}]}},"/media/{id}/file":{"put":{"operationId":"putMediaByIdFile","tags":["Media"],"summary":"Upload the whole file (up to 95 MB).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false}},"required":["media"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","contentMediaType":"application/octet-stream"}}}}}},"/media/{id}/parts/{n}":{"put":{"operationId":"putMediaByIdPartsByN","tags":["Media"],"summary":"Upload one part of a multipart upload.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"partNumber":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["partNumber","bytes"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"n","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","contentMediaType":"application/octet-stream"}}}}}},"/media/{id}/complete":{"post":{"operationId":"postMediaByIdComplete","tags":["Media"],"summary":"Finish a multipart upload.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false}},"required":["media"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/media/{id}/poster":{"put":{"operationId":"putMediaByIdPoster","tags":["Media"],"summary":"Upload a video's poster frame (JPEG).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false}},"required":["media"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","contentMediaType":"application/octet-stream"}}}}}},"/media/import":{"post":{"operationId":"postMediaImport","tags":["Media"],"summary":"Import a file from a public HTTPS URL.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false}},"required":["media"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"fileName":{"type":"string","minLength":1,"maxLength":255},"altText":{"type":"string","maxLength":1000}},"required":["url"],"additionalProperties":false}}}}}},"/media/{id}":{"get":{"operationId":"getMediaById","tags":["Media"],"summary":"One file (and the parts stored while it uploads).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false},"partsStored":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"required":["media"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"patch":{"operationId":"patchMediaById","tags":["Media"],"summary":"Change a file's alt text or name.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false}},"required":["media"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"altText":{"type":"string","maxLength":1000},"fileName":{"type":"string","minLength":1,"maxLength":255}},"additionalProperties":false}}}}},"delete":{"operationId":"deleteMediaById","tags":["Media"],"summary":"Delete a file.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"204":{"description":"Done."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"force","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}]}},"/media/delete":{"post":{"operationId":"postMediaDelete","tags":["Media"],"summary":"Delete several files.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["deleted"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},"force":{"type":"boolean"}},"required":["ids"],"additionalProperties":false}}}}}},"/posts":{"get":{"operationId":"getPosts","tags":["Posts"],"summary":"Posts by tab.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"tab","in":"query","required":false,"schema":{"type":"string","enum":["scheduled","drafts","posted","failed"]}},{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}},{"name":"accountId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"},{"maxItems":53,"type":"array","items":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"}}]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}}]},"post":{"operationId":"postPosts","tags":["Posts"],"summary":"Create a post (a draft unless a schedule is sent).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false},"issues":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["error","warning","note"]},"code":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"accountId":{"type":["string","null"]},"field":{"type":["string","null"]},"mediaIndex":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"itemIndex":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"message":{"type":"string"}},"required":["level","code","provider","message"],"additionalProperties":false}},"adjusted":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["gap","overlap"]},"requested":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"used":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"timezone":{"type":"string"}},"required":["kind","requested","used","timezone"],"additionalProperties":false},{"type":"null"}]}},"required":["post","issues","adjusted"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"anyOf":[{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]},"text":{"type":"string","maxLength":10000},"mediaIds":{"maxItems":35,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},"coverMs":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"targets":{"maxItems":53,"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"},"text":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}]},"mediaIds":{"anyOf":[{"maxItems":35,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"confirmTikTok":{"type":"boolean","const":true}},"required":["accountId"],"additionalProperties":false}},"schedule":{"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"draft"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"at"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"queue"}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"now"}},"required":["mode"],"additionalProperties":false}]}},"additionalProperties":false}}}}}},"/calendar":{"get":{"operationId":"getCalendar","tags":["Posts"],"summary":"Calendar entries between two dates (one per post and time).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"postId":{"type":"string"},"at":{"type":"string"},"local":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"targetIds":{"type":"array","items":{"type":"string"}},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"avatarUrl":{"type":["string","null"]}},"required":["id","provider","handle","avatarUrl"],"additionalProperties":false}},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"text":{"type":"string"},"thumbUrl":{"type":["string","null"]},"draggable":{"type":"boolean"},"updatedAt":{"type":"string"}},"required":["postId","at","local","targetIds","accounts","state","text","thumbUrl","draggable"],"additionalProperties":false}}},"required":["timezone","data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}},{"name":"accountId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"},{"maxItems":53,"type":"array","items":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"}}]}}]}},"/posts/counts":{"get":{"operationId":"getPostsCounts","tags":["Posts"],"summary":"How many posts each tab has.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"scheduled":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"drafts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"posted":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["scheduled","drafts","posted","failed"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}}]}},"/posts/{id}":{"get":{"operationId":"getPostsById","tags":["Posts"],"summary":"One post with each account.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false}},"required":["post"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"patch":{"operationId":"patchPostsById","tags":["Posts"],"summary":"Change a post that has not gone out.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false},"issues":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["error","warning","note"]},"code":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"accountId":{"type":["string","null"]},"field":{"type":["string","null"]},"mediaIndex":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"itemIndex":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"message":{"type":"string"}},"required":["level","code","provider","message"],"additionalProperties":false}}},"required":["post","issues"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"anyOf":[{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]},"text":{"type":"string","maxLength":10000},"mediaIds":{"maxItems":35,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},"coverMs":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"targets":{"maxItems":53,"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"},"text":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}]},"mediaIds":{"anyOf":[{"maxItems":35,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"confirmTikTok":{"type":"boolean","const":true}},"required":["accountId"],"additionalProperties":false}},"schedule":{"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"draft"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"at"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"queue"}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"now"}},"required":["mode"],"additionalProperties":false}]},"expectedUpdatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"additionalProperties":false}}}}},"delete":{"operationId":"deletePostsById","tags":["Posts"],"summary":"Delete a post (and, if asked, on the platforms).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string"},"deleted":{"type":"boolean"},"message":{"type":"string"}},"required":["accountId","deleted"],"additionalProperties":false}}},"required":["results"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alsoOnPlatforms","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}]}},"/posts/validate":{"post":{"operationId":"postPostsValidate","tags":["Posts"],"summary":"Check a post without saving it (a dry run).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["error","warning","note"]},"code":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"accountId":{"type":["string","null"]},"field":{"type":["string","null"]},"mediaIndex":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"itemIndex":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"message":{"type":"string"}},"required":["level","code","provider","message"],"additionalProperties":false}},"xUnits":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resolved":{"anyOf":[{"type":"object","properties":{"at":{"type":"string"},"local":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"}},"required":["at","local"],"additionalProperties":false},{"type":"null"}]},"adjusted":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["gap","overlap"]},"requested":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"used":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"timezone":{"type":"string"}},"required":["kind","requested","used","timezone"],"additionalProperties":false},{"type":"null"}]}},"required":["issues","xUnits","resolved"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"anyOf":[{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]},"text":{"type":"string","maxLength":10000},"mediaIds":{"maxItems":35,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},"coverMs":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"targets":{"maxItems":53,"type":"array","items":{"type":"object","properties":{"accountId":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"},"text":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}]},"mediaIds":{"anyOf":[{"maxItems":35,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"confirmTikTok":{"type":"boolean","const":true}},"required":["accountId"],"additionalProperties":false}},"schedule":{"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"draft"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"at"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"queue"}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"now"}},"required":["mode"],"additionalProperties":false}]}},"additionalProperties":false}}}}}},"/posts/{id}/schedule":{"post":{"operationId":"postPostsByIdSchedule","tags":["Posts"],"summary":"Schedule, queue, post now or move a post.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false},"adjusted":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["gap","overlap"]},"requested":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"used":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"timezone":{"type":"string"}},"required":["kind","requested","used","timezone"],"additionalProperties":false},{"type":"null"}]}},"required":["post","adjusted"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"schedule":{"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"draft"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"at"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"queue"}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"now"}},"required":["mode"],"additionalProperties":false}]},"targetIds":{"minItems":1,"maxItems":53,"type":"array","items":{"type":"string","pattern":"^pt_[0-9A-HJKMNP-TV-Z]{26}$"}},"expectedUpdatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["schedule"],"additionalProperties":false}}}}}},"/posts/{id}/unschedule":{"post":{"operationId":"postPostsByIdUnschedule","tags":["Posts"],"summary":"Back to drafts, time kept.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false}},"required":["post"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}]}},"/posts/{id}/duplicate":{"post":{"operationId":"postPostsByIdDuplicate","tags":["Posts"],"summary":"Copy a post as a new draft.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false}},"required":["post"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}]}},"/posts/bulk":{"post":{"operationId":"postPostsBulk","tags":["Posts"],"summary":"One post per file, all or nothing (Creator and Pro).","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"batchId":{"type":"string"},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false}}},"required":["batchId","posts"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountIds":{"minItems":1,"maxItems":53,"type":"array","items":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"}},"mode":{"type":"string","enum":["queue","draft"]},"items":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","maxLength":10000},"mediaIds":{"maxItems":35,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},"coverMs":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"additionalProperties":false}}},"required":["accountIds","mode","items"],"additionalProperties":false}}}}}},"/posts/{id}/metrics":{"get":{"operationId":"getPostsByIdMetrics","tags":["Analytics"],"summary":"The latest numbers of each of a post's accounts.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"postId":{"type":"string"},"engagementLocked":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"url":{"type":["string","null"]},"publishedAt":{"type":"string"},"measuredAt":{"type":["string","null"]},"views":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"likes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"reposts":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"quotes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["targetId","accountId","provider","handle","url","publishedAt","measuredAt","views","likes","reposts","replies","quotes"],"additionalProperties":false}}},"required":["postId","engagementLocked","data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/targets/{id}/retry":{"post":{"operationId":"postTargetsByIdRetry","tags":["Posts"],"summary":"Retry one account of a post.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false}},"required":["post"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"now"}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"schedule":{"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"draft"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"at"},"at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},"atUtc":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timezone":{"type":"string","maxLength":64}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"queue"}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"now"}},"required":["mode"],"additionalProperties":false}]}},"required":["schedule"],"additionalProperties":false}]}}}}}},"/targets/requeue":{"post":{"operationId":"postTargetsRequeue","tags":["Posts"],"summary":"Add missed or failed accounts to the queue.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string"},"at":{"type":"string"},"local":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"}},"required":["targetId","at","local"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targetIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^pt_[0-9A-HJKMNP-TV-Z]{26}$"}}},"required":["targetIds"],"additionalProperties":false}}}}}},"/targets/{id}/resolve":{"post":{"operationId":"postTargetsByIdResolve","tags":["Posts"],"summary":"Say whether a post that needs a check went out.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false}},"required":["post"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"outcome":{"type":"string","const":"posted"},"url":{"type":"string","maxLength":2048,"format":"uri"}},"required":["outcome"],"additionalProperties":false},{"type":"object","properties":{"outcome":{"type":"string","const":"not_posted"}},"required":["outcome"],"additionalProperties":false}]}}}}}},"/targets/{id}":{"delete":{"operationId":"deleteTargetsById","tags":["Posts"],"summary":"Remove one account from a post.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false},"deleted":{"type":"boolean"},"message":{"type":"string"}},"required":["post","deleted"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"alsoOnPlatform","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}]}},"/targets/{id}/attempts":{"get":{"operationId":"getTargetsByIdAttempts","tags":["Posts"],"summary":"Every step of one account's publishing.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"step":{"type":"string"},"attempt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"startedAt":{"type":"string"},"finishedAt":{"type":["string","null"]},"outcome":{"anyOf":[{"type":"string","enum":["ok","error","unknown"]},{"type":"null"}]},"httpStatus":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"code":{"type":["string","null"]},"message":{"type":["string","null"]}},"required":["step","attempt","startedAt","finishedAt","outcome","httpStatus","code","message"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/plans":{"get":{"operationId":"getPlans","tags":["Billing"],"summary":"The plans and their limits.","description":"Anyone (no sign-in).","security":[],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["starter","creator","pro"]},"name":{"type":"string"},"monthly":{"type":"number"},"yearly":{"type":"number"},"accounts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"members":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"xPostsPerMonth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxVideoBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxImageBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"storageBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bulkUpload":{"type":"boolean"},"apps":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"engagementAnalytics":{"type":"boolean"},"trialDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","name","monthly","yearly","accounts","members","xPostsPerMonth","maxVideoBytes","maxImageBytes","storageBytes","bulkUpload","apps","engagementAnalytics","trialDays"],"additionalProperties":false}},"trialDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"currency":{"type":"string","const":"usd"}},"required":["data","trialDays","currency"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/billing":{"get":{"operationId":"getBilling","tags":["Billing"],"summary":"The workspace's plan and usage.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"anyOf":[{"type":"string","enum":["starter","creator","pro"]},{"type":"null"}]},"interval":{"anyOf":[{"type":"string","enum":["month","year"]},{"type":"null"}]},"status":{"type":"string","enum":["none","trialing","active","past_due","canceled","unpaid","incomplete","incomplete_expired","paused"]},"active":{"type":"boolean"},"trialEndsAt":{"type":["string","null"]},"currentPeriodEnd":{"type":["string","null"]},"cancelAtPeriodEnd":{"type":"boolean"},"graceEndsAt":{"type":["string","null"]},"canManage":{"type":"boolean"},"trialAvailable":{"type":"boolean"},"usage":{"type":"object","properties":{"accounts":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["used","limit"],"additionalProperties":false},"members":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["used","limit"],"additionalProperties":false},"storage":{"type":"object","properties":{"usedBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limitBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["usedBytes","limitBytes"],"additionalProperties":false},"xPosts":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resetsAt":{"type":"string"}},"required":["used","limit","resetsAt"],"additionalProperties":false},"apps":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["used","limit"],"additionalProperties":false}},"required":["accounts","members","storage","xPosts","apps"],"additionalProperties":false}},"required":["plan","interval","status","active","trialEndsAt","currentPeriodEnd","cancelAtPeriodEnd","graceEndsAt","canManage","trialAvailable","usage"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/billing/checkout":{"post":{"operationId":"postBillingCheckout","tags":["Billing"],"summary":"Start a plan (Stripe Checkout).","description":"The workspace owner, signed in.","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"string","enum":["starter","creator","pro"]},"interval":{"type":"string","enum":["month","year"]},"resumePostId":{"type":"string","pattern":"^post_[0-9A-HJKMNP-TV-Z]{26}$"}},"required":["plan","interval"],"additionalProperties":false}}}}}},"/billing/checkout-status":{"get":{"operationId":"getBillingCheckoutStatus","tags":["Billing"],"summary":"Sync after Checkout.","description":"The workspace owner, signed in.","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"anyOf":[{"type":"string","enum":["starter","creator","pro"]},{"type":"null"}]},"interval":{"anyOf":[{"type":"string","enum":["month","year"]},{"type":"null"}]},"status":{"type":"string","enum":["none","trialing","active","past_due","canceled","unpaid","incomplete","incomplete_expired","paused"]},"active":{"type":"boolean"},"trialEndsAt":{"type":["string","null"]},"currentPeriodEnd":{"type":["string","null"]},"cancelAtPeriodEnd":{"type":"boolean"},"graceEndsAt":{"type":["string","null"]},"canManage":{"type":"boolean"},"trialAvailable":{"type":"boolean"},"usage":{"type":"object","properties":{"accounts":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["used","limit"],"additionalProperties":false},"members":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["used","limit"],"additionalProperties":false},"storage":{"type":"object","properties":{"usedBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limitBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["usedBytes","limitBytes"],"additionalProperties":false},"xPosts":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resetsAt":{"type":"string"}},"required":["used","limit","resetsAt"],"additionalProperties":false},"apps":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["used","limit"],"additionalProperties":false}},"required":["accounts","members","storage","xPosts","apps"],"additionalProperties":false}},"required":["plan","interval","status","active","trialEndsAt","currentPeriodEnd","cancelAtPeriodEnd","graceEndsAt","canManage","trialAvailable","usage"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"session_id","in":"query","required":true,"schema":{"type":"string","pattern":"^cs_[A-Za-z0-9_]{1,200}$"}}]}},"/billing/portal":{"post":{"operationId":"postBillingPortal","tags":["Billing"],"summary":"Open the Stripe billing portal.","description":"The workspace owner, signed in.","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"returnTo":{"type":"string","minLength":1,"maxLength":2048,"format":"starts_with","pattern":"^\\/.*"}},"additionalProperties":false}}}}}},"/api-keys":{"get":{"operationId":"getApiKeys","tags":["API keys"],"summary":"API keys and CLI sign-ins (members see their own CLI sign-ins).","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display":{"type":"string"},"createdBy":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"kind":{"type":"string","enum":["workspace","integration","cli"]},"scopes":{"anyOf":[{"type":"array","items":{"type":"string","enum":["media:write","posts:draft"]}},{"type":"null"}]},"appId":{"type":["string","null"]},"deviceName":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["id","name","display","createdBy","lastUsedAt","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"postApiKeys","tags":["API keys"],"summary":"Create an API key (the key is shown only here).","description":"Admins and the owner, signed in (API keys get 403).","security":[{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display":{"type":"string"},"createdBy":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"kind":{"type":"string","enum":["workspace","integration","cli"]},"scopes":{"anyOf":[{"type":"array","items":{"type":"string","enum":["media:write","posts:draft"]}},{"type":"null"}]},"appId":{"type":["string","null"]},"deviceName":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["id","name","display","createdBy","lastUsedAt","createdAt"],"additionalProperties":false},"key":{"type":"string","pattern":"^pmx_[A-Za-z0-9_-]{43}$"}},"required":["apiKey","key"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"required":["name"],"additionalProperties":false}}}}}},"/api-keys/{id}":{"delete":{"operationId":"deleteApiKeysById","tags":["API keys"],"summary":"Revoke an API key or a CLI sign-in.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"204":{"description":"Done."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/audit":{"get":{"operationId":"getAudit","tags":["API keys"],"summary":"Activity, newest first.","description":"Admins and the owner, signed in (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"action":{"type":"string","enum":["auth.sign_in","workspace.created","workspace.updated","workspace.deleted","member.invited","member.joined","member.removed","member.role_changed","member.invitation_canceled","ownership.transferred","account.connected","account.removed","account.reconnected","account.reconnect_needed","account.over_limit","post.created","post.scheduled","post.edited","post.unscheduled","post.deleted","post.published","post.failed","post.resolved","plan.changed","api_key.created","api_key.revoked","slots.updated","app.created","app.updated","app.deleted","account.moved","integration.connected","integration.disconnected","integration.draft_received","analytics.settings_updated","cli_login.approved","cli_login.denied"]},"actor":{"type":"object","properties":{"kind":{"type":"string","enum":["user","api_key","system","stripe"]},"name":{"type":["string","null"]}},"required":["kind","name"],"additionalProperties":false},"target":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":false},{"type":"null"}]},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"}},"required":["id","action","actor","target","meta","createdAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}}]}},"/test-channel/{targetId}":{"get":{"operationId":"getTestChannelByTargetId","tags":["Accounts"],"summary":"What a Test channel post received.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"mime":{"type":"string"},"fileName":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"},"status":{"type":"string","enum":["uploading","ready","failed"]},"url":{"type":["string","null"]},"thumbUrl":{"type":["string","null"]},"posterUrl":{"type":["string","null"]},"usedIn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","kind","mime","fileName","bytes","width","height","durationMs","altText","status","url","thumbUrl","posterUrl","usedIn","createdAt"],"additionalProperties":false}},"publishedAt":{"type":["string","null"]}},"required":["id","text","media","publishedAt"],"additionalProperties":false},"account":{"type":"object","properties":{"id":{"type":"string"},"appId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]},"statusReason":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"isTest":{"type":"boolean"},"testBehavior":{"anyOf":[{"type":"string","enum":["ok","fail_once","busy_once","unclear_found_once","unclear_lost_once","signed_out","slow_once"]},{"type":"null"}]},"limits":{"type":"object","properties":{"maxCharacters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxMedia":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maxCharacters","maxMedia"],"additionalProperties":false},"createdAt":{"type":"string"},"removedAt":{"type":["string","null"]}},"required":["id","appId","provider","handle","displayName","avatarUrl","status","statusReason","expiresAt","isTest","testBehavior","limits","createdAt"],"additionalProperties":false}},"required":["post","account"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"targetId","in":"path","required":true,"schema":{"type":"string"}}]}},"/openapi.json":{"get":{"operationId":"getOpenapiJson","tags":["Meta"],"summary":"This document.","description":"Anyone (no sign-in).","security":[],"responses":{"200":{"description":"OK."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/apps":{"get":{"operationId":"getApps","tags":["Apps"],"summary":"Apps in rail order.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"websiteUrl":{"type":["string","null"]},"iconMediaId":{"type":["string","null"]},"iconUrl":{"type":["string","null"]},"color":{"anyOf":[{"type":"string","enum":["red","orange","yellow","green","teal","blue","purple","pink"]},{"type":"null"}]},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"accountCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","websiteUrl","iconMediaId","iconUrl","color","position","accountCount","createdAt","updatedAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"postApps","tags":["Apps"],"summary":"Add an app.","description":"Admins and the owner, and CLI sign-ins they approved (other API keys get 403).","security":[{"session":[]},{"apiKey":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"app":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"websiteUrl":{"type":["string","null"]},"iconMediaId":{"type":["string","null"]},"iconUrl":{"type":["string","null"]},"color":{"anyOf":[{"type":"string","enum":["red","orange","yellow","green","teal","blue","purple","pink"]},{"type":"null"}]},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"accountCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","websiteUrl","iconMediaId","iconUrl","color","position","accountCount","createdAt","updatedAt"],"additionalProperties":false}},"required":["app"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Replays the first response for 24 h; a replay carries Idempotent-Replayed: true."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"websiteUrl":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"iconMediaId":{"anyOf":[{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]},"color":{"anyOf":[{"type":"string","enum":["red","orange","yellow","green","teal","blue","purple","pink"]},{"type":"null"}]}},"required":["name"],"additionalProperties":false}}}}}},"/apps/{id}":{"get":{"operationId":"getAppsById","tags":["Apps"],"summary":"One app.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"app":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"websiteUrl":{"type":["string","null"]},"iconMediaId":{"type":["string","null"]},"iconUrl":{"type":["string","null"]},"color":{"anyOf":[{"type":"string","enum":["red","orange","yellow","green","teal","blue","purple","pink"]},{"type":"null"}]},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"accountCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","websiteUrl","iconMediaId","iconUrl","color","position","accountCount","createdAt","updatedAt"],"additionalProperties":false}},"required":["app"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"patch":{"operationId":"patchAppsById","tags":["Apps"],"summary":"Change an app.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"app":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"websiteUrl":{"type":["string","null"]},"iconMediaId":{"type":["string","null"]},"iconUrl":{"type":["string","null"]},"color":{"anyOf":[{"type":"string","enum":["red","orange","yellow","green","teal","blue","purple","pink"]},{"type":"null"}]},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"accountCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","websiteUrl","iconMediaId","iconUrl","color","position","accountCount","createdAt","updatedAt"],"additionalProperties":false}},"required":["app"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"websiteUrl":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"iconMediaId":{"anyOf":[{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]},"color":{"anyOf":[{"type":"string","enum":["red","orange","yellow","green","teal","blue","purple","pink"]},{"type":"null"}]}},"additionalProperties":false}}}}},"delete":{"operationId":"deleteAppsById","tags":["Apps"],"summary":"Delete an empty app.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"integrationsRevoked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"draftsWithoutApp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["integrationsRevoked","draftsWithoutApp"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"preview","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}]}},"/apps/order":{"put":{"operationId":"putAppsOrder","tags":["Apps"],"summary":"Reorder the apps.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"websiteUrl":{"type":["string","null"]},"iconMediaId":{"type":["string","null"]},"iconUrl":{"type":["string","null"]},"color":{"anyOf":[{"type":"string","enum":["red","orange","yellow","green","teal","blue","purple","pink"]},{"type":"null"}]},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"accountCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","websiteUrl","iconMediaId","iconUrl","color","position","accountCount","createdAt","updatedAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appIds":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}}},"required":["appIds"],"additionalProperties":false}}}}}},"/apps/{id}/accounts":{"post":{"operationId":"postAppsByIdAccounts","tags":["Apps"],"summary":"Move accounts into this app.","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"appId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]},"statusReason":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"isTest":{"type":"boolean"},"testBehavior":{"anyOf":[{"type":"string","enum":["ok","fail_once","busy_once","unclear_found_once","unclear_lost_once","signed_out","slow_once"]},{"type":"null"}]},"limits":{"type":"object","properties":{"maxCharacters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxMedia":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maxCharacters","maxMedia"],"additionalProperties":false},"createdAt":{"type":"string"},"removedAt":{"type":["string","null"]}},"required":["id","appId","provider","handle","displayName","avatarUrl","status","statusReason","expiresAt","isTest","testBehavior","limits","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountIds":{"minItems":1,"maxItems":53,"type":"array","items":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"}}},"required":["accountIds"],"additionalProperties":false}}}}}},"/analytics/summary":{"get":{"operationId":"getAnalyticsSummary","tags":["Analytics"],"summary":"Totals for a range.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"timezone":{"type":"string"},"appId":{"type":["string","null"]},"engagementLocked":{"type":"boolean"},"activity":{"type":"object","properties":{"published":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991},"scheduled":{"type":"integer","minimum":0,"maximum":9007199254740991},"streakDays":{"type":"integer","minimum":0,"maximum":9007199254740991},"bestHours":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"hour":{"type":"integer","minimum":0,"maximum":23},"published":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["hour","published"],"additionalProperties":false}}},"required":["published","failed","scheduled","streakDays","bestHours"],"additionalProperties":false},"engagement":{"type":"object","properties":{"views":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"likes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"reposts":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["views","likes","reposts","replies"],"additionalProperties":false},"platforms":{"type":"array","items":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]}},"reportedBy":{"type":"object","properties":{"views":{"type":"array","items":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]}},"likes":{"type":"array","items":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]}},"reposts":{"type":"array","items":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]}},"replies":{"type":"array","items":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]}}},"required":["views","likes","reposts","replies"],"additionalProperties":false}},"required":["from","to","timezone","appId","engagementLocked","activity","engagement","platforms","reportedBy"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}},{"name":"accountId","in":"query","required":false,"schema":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"}}]}},"/analytics/daily":{"get":{"operationId":"getAnalyticsDaily","tags":["Analytics"],"summary":"Every day of a range.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"timezone":{"type":"string"},"appId":{"type":["string","null"]},"engagementLocked":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"published":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"likes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"reposts":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["day","published","failed","views","likes","reposts","replies"],"additionalProperties":false}}},"required":["from","to","timezone","appId","engagementLocked","data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}},{"name":"accountId","in":"query","required":false,"schema":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"}}]}},"/analytics/by":{"get":{"operationId":"getAnalyticsBy","tags":["Analytics"],"summary":"By app, or by account inside one app.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"timezone":{"type":"string"},"appId":{"type":["string","null"]},"engagementLocked":{"type":"boolean"},"group":{"type":"string","enum":["app","account"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"provider":{"anyOf":[{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},{"type":"null"}]},"handle":{"type":["string","null"]},"appId":{"type":["string","null"]},"published":{"type":"integer","minimum":0,"maximum":9007199254740991},"failed":{"type":"integer","minimum":0,"maximum":9007199254740991},"views":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"likes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"reposts":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"followers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","name","provider","handle","appId","published","failed","views","likes","reposts","replies","followers"],"additionalProperties":false}}},"required":["from","to","timezone","appId","engagementLocked","group","data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"group","in":"query","required":true,"schema":{"type":"string","enum":["app","account"]}},{"name":"from","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}}]}},"/analytics/top-posts":{"get":{"operationId":"getAnalyticsTopPosts","tags":["Analytics"],"summary":"Published posts by engagement.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"timezone":{"type":"string"},"appId":{"type":["string","null"]},"engagementLocked":{"type":"boolean"},"data":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"postId":{"type":"string"},"targetId":{"type":"string"},"appId":{"type":["string","null"]},"account":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"handle":{"type":"string"}},"required":["id","provider","handle"],"additionalProperties":false},"text":{"type":"string"},"publishedAt":{"type":"string"},"url":{"type":["string","null"]},"views":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"likes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"reposts":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"engagement":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["postId","targetId","appId","account","text","publishedAt","url","views","likes","reposts","replies","engagement"],"additionalProperties":false}}},"required":["from","to","timezone","appId","engagementLocked","data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}},{"name":"accountId","in":"query","required":false,"schema":{"type":"string","pattern":"^acc_[0-9A-HJKMNP-TV-Z]{26}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"integer","minimum":1,"maximum":10}}]}},"/analytics/settings":{"get":{"operationId":"getAnalyticsSettings","tags":["Analytics"],"summary":"Whether X numbers are read.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"xMetrics":{"type":"boolean"},"xAvailable":{"type":"boolean"}},"required":["xMetrics","xAvailable"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"putAnalyticsSettings","tags":["Analytics"],"summary":"Turn X numbers on or off (each read costs X credits).","description":"Admins and the owner (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"xMetrics":{"type":"boolean"},"xAvailable":{"type":"boolean"}},"required":["xMetrics","xAvailable"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"xMetrics":{"type":"boolean"}},"required":["xMetrics"],"additionalProperties":false}}}}}},"/integrations":{"get":{"operationId":"getIntegrations","tags":["Integrations"],"summary":"Connected integrations.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["brainlane"]},"app":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"key":{"type":"object","properties":{"display":{"type":"string"},"lastUsedAt":{"type":["string","null"]}},"required":["display","lastUsedAt"],"additionalProperties":false},"connectedBy":{"type":["string","null"]},"createdAt":{"type":"string"},"lastEventAt":{"type":["string","null"]},"status":{"type":"string","enum":["connected","key_revoked"]}},"required":["id","kind","app","key","connectedBy","createdAt","lastEventAt","status"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/integrations/brainlane":{"post":{"operationId":"postIntegrationsBrainlane","tags":["Integrations"],"summary":"Connect Brainlane for one app (the key is shown only here).","description":"Admins and the owner, signed in (API keys get 403).","security":[{"session":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"integration":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["brainlane"]},"app":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"key":{"type":"object","properties":{"display":{"type":"string"},"lastUsedAt":{"type":["string","null"]}},"required":["display","lastUsedAt"],"additionalProperties":false},"connectedBy":{"type":["string","null"]},"createdAt":{"type":"string"},"lastEventAt":{"type":["string","null"]},"status":{"type":"string","enum":["connected","key_revoked"]}},"required":["id","kind","app","key","connectedBy","createdAt","lastEventAt","status"],"additionalProperties":false},"key":{"type":"string"},"setup":{"type":"object","properties":{"postmaxxUrl":{"type":"string"},"apiKey":{"type":"string"}},"required":["postmaxxUrl","apiKey"],"additionalProperties":false}},"required":["integration","key","setup"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appId":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}},"required":["appId"],"additionalProperties":false}}}}}},"/integrations/{id}":{"delete":{"operationId":"deleteIntegrationsById","tags":["Integrations"],"summary":"Disconnect an integration.","description":"Admins and the owner, signed in (API keys get 403).","security":[{"session":[]}],"responses":{"204":{"description":"Done."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/integrations/new-drafts":{"get":{"operationId":"getIntegrationsNewDrafts","tags":["Integrations"],"summary":"Integration drafts nobody has opened.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"data":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"postId":{"type":"string"},"kind":{"type":"string","enum":["brainlane"]},"appId":{"type":["string","null"]},"text":{"type":"string"},"thumbUrl":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["postId","kind","appId","text","thumbUrl","createdAt"],"additionalProperties":false}}},"required":["count","data"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}}]}},"/integrations/new-drafts/seen":{"post":{"operationId":"postIntegrationsNewDraftsSeen","tags":["Integrations"],"summary":"Mark integration drafts as opened.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"seen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["seen"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"postIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^post_[0-9A-HJKMNP-TV-Z]{26}$"}}},"required":["postIds"],"additionalProperties":false}}}}}},"/integrations/brainlane/connection":{"get":{"operationId":"getIntegrationsBrainlaneConnection","tags":["Integrations"],"summary":"Brainlane checks its key: the workspace and app.","description":"API keys only.","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"workspace":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"app":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"required":["workspace","app"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"appId","in":"query","required":false,"schema":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}}]}},"/integrations/brainlane/drafts":{"post":{"operationId":"postIntegrationsBrainlaneDrafts","tags":["Integrations"],"summary":"Brainlane sends a finished video as a draft.","description":"API keys only.","security":[{"apiKey":[]}],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"string","enum":["created","updated","newer_version"]},"post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false}},"required":["result","post"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"externalRef":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9._:\\/-]+$"},"caption":{"type":"string","maxLength":20000},"mediaIds":{"default":[],"maxItems":35,"type":"array","items":{"type":"string","pattern":"^med_[0-9A-HJKMNP-TV-Z]{26}$"}},"coverMs":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"appId":{"type":"string","pattern":"^app_[0-9A-HJKMNP-TV-Z]{26}$"}},"required":["externalRef","caption"],"additionalProperties":false}}}}}},"/cli/logins":{"post":{"operationId":"postCliLogins","tags":["CLI"],"summary":"The CLI starts a sign-in (sends only its key hash).","description":"Anyone (no sign-in).","security":[],"responses":{"201":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"deviceCode":{"type":"string","pattern":"^pmxd_[A-Za-z0-9_-]{43}$"},"userCode":{"type":"string"},"expiresAt":{"type":"string"},"interval":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["deviceCode","userCode","expiresAt","interval"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deviceName":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,59}$"},"cliVersion":{"type":"string","pattern":"^\\d{1,4}\\.\\d{1,5}\\.\\d{1,6}(-[0-9A-Za-z.]{1,20})?$"},"keyHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"keyDisplay":{"type":"string","pattern":"^pmx_[A-Za-z0-9_-]{4}…[A-Za-z0-9_-]{4}$"},"replaces":{"type":"string","pattern":"^pmxd_[A-Za-z0-9_-]{43}$"}},"required":["deviceName","cliVersion","keyHash","keyDisplay"],"additionalProperties":false}}}}}},"/cli/logins/token":{"post":{"operationId":"postCliLoginsToken","tags":["CLI"],"summary":"The CLI polls its sign-in (every 5 s).","description":"Anyone (no sign-in).","security":[],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"denied"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"expired"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"apiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display":{"type":"string"},"createdBy":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"kind":{"type":"string","enum":["workspace","integration","cli"]},"scopes":{"anyOf":[{"type":"array","items":{"type":"string","enum":["media:write","posts:draft"]}},{"type":"null"}]},"appId":{"type":["string","null"]},"deviceName":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["id","name","display","createdBy","lastUsedAt","createdAt"],"additionalProperties":false},"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"}},"required":["id","name","timezone"],"additionalProperties":false},"person":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false}},"required":["status","apiKey","workspace","person"],"additionalProperties":false}]}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deviceCode":{"type":"string","pattern":"^pmxd_[A-Za-z0-9_-]{43}$"}},"required":["deviceCode"],"additionalProperties":false}}}}}},"/cli/logins/lookup":{"post":{"operationId":"postCliLoginsLookup","tags":["CLI"],"summary":"Look up a typed code on /device.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"deviceName":{"type":"string"},"cliVersion":{"type":"string"},"country":{"type":["string","null"]},"yourCountry":{"type":["string","null"]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"workspaces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]}},"required":["id","name","role"],"additionalProperties":false}}},"required":["deviceName","cliVersion","country","yourCountry","createdAt","expiresAt","workspaces"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userCode":{"type":"string","minLength":1,"maxLength":32}},"required":["userCode"],"additionalProperties":false}}}}}},"/cli/logins/approve":{"post":{"operationId":"postCliLoginsApprove","tags":["CLI"],"summary":"Approve a CLI sign-in into this workspace.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"deviceName":{"type":"string"}},"required":["workspace","deviceName"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userCode":{"type":"string","minLength":1,"maxLength":32}},"required":["userCode"],"additionalProperties":false}}}}}},"/cli/logins/deny":{"post":{"operationId":"postCliLoginsDeny","tags":["CLI"],"summary":"Deny a CLI sign-in.","description":"A signed-in person (API keys get 403).","security":[{"session":[]}],"responses":{"204":{"description":"Done."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userCode":{"type":"string","minLength":1,"maxLength":32}},"required":["userCode"],"additionalProperties":false}}}}}},"/whoami":{"get":{"operationId":"getWhoami","tags":["CLI"],"summary":"Who is calling: the key, the person, the workspace, the plan.","description":"Members, admins, the owner and API keys.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["api_key","session"]},"apiKey":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display":{"type":"string"},"createdBy":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"kind":{"type":"string","enum":["workspace","integration","cli"]},"scopes":{"anyOf":[{"type":"array","items":{"type":"string","enum":["media:write","posts:draft"]}},{"type":"null"}]},"appId":{"type":["string","null"]},"deviceName":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["id","name","display","createdBy","lastUsedAt","createdAt"],"additionalProperties":false},{"type":"null"}]},"person":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]}},"required":["id","name","role"],"additionalProperties":false},{"type":"null"}]},"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"weekStart":{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},"timeFormat":{"type":"string","enum":["24h","12h"]}},"required":["id","name","timezone","weekStart","timeFormat"],"additionalProperties":false},"plan":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","enum":["starter","creator","pro"]},{"type":"null"}]},"active":{"type":"boolean"}},"required":["id","active"],"additionalProperties":false}},"required":["kind","apiKey","person","workspace","plan"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/whoami/key":{"delete":{"operationId":"deleteWhoamiKey","tags":["CLI"],"summary":"Revoke the calling API key (postmaxx logout).","description":"API keys only.","security":[{"apiKey":[]}],"responses":{"204":{"description":"Done."},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/cli":{"get":{"operationId":"getCli","tags":["CLI"],"summary":"The CLI package, its versions and whether it is published.","description":"Anyone (no sign-in).","security":[],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"type":"object","properties":{"published":{"type":"boolean"},"package":{"type":"string"},"latestVersion":{"type":"string"},"minimumVersion":{"type":"string"},"install":{"type":"string"},"skillUrl":{"type":"string"}},"required":["published","package","latestVersion","minimumVersion","install","skillUrl"],"additionalProperties":false}}}},"default":{"description":"An error (api.md §1.1).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key: pmx_ + 43 characters."},"session":{"type":"apiKey","in":"cookie","name":"pmx.session_token","description":"The web app session. Non-GET calls need Origin."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","unauthorized","plan_required","plan_limit","app_limit","forbidden","scope_forbidden","origin_mismatch","not_found","method_not_allowed","conflict","account_needs_reconnect","app_not_empty","idempotency_conflict","idempotency_in_progress","upload_incomplete","too_large","unsupported_media","validation_failed","provider_disabled","no_free_slot","too_many_workspaces","rate_limited","internal","unavailable"]},"message":{"type":"string"},"requestId":{"type":"string"},"fields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"issues":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["error","warning","note"]},"code":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"accountId":{"type":["string","null"]},"field":{"type":["string","null"]},"mediaIndex":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"itemIndex":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"message":{"type":"string"}},"required":["level","code","provider","message"],"additionalProperties":false}},"feature":{"type":"string","enum":["schedule","bulk"]},"limit":{"type":"object","properties":{"name":{"type":"string","enum":["accounts","test_channels","members","storage","apps"]},"used":{"type":"number"},"max":{"type":"number"}},"required":["name","used","max"],"additionalProperties":false},"upgradeUrl":{"type":"string"},"reason":{"type":"string","enum":["publishing","stale","in_use","owns_shared_workspace","subscription_exists","already_connected","already_member","last_app"]},"accountIds":{"type":"array","items":{"type":"string"}},"missingParts":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"maxBytes":{"type":"number"},"workspaceNames":{"type":"array","items":{"type":"string"}},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"scheduledAt":{"type":["string","null"]},"becomesDraft":{"type":"boolean"}},"required":["id","scheduledAt","becomesDraft"],"additionalProperties":false}}},"required":["code","message","requestId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"Post":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},"coverMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"source":{"type":"string","enum":["app","api","mcp","bulk","brainlane","cli"]},"appId":{"type":["string","null"]},"externalRef":{"type":["string","null"]},"newerVersion":{"type":"boolean"},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"state":{"type":"string","enum":["draft","scheduled","posting","posted","failed","check","paused","missed"]},"summary":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"timezone":{"type":["string","null"]},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"provider":{"type":"string","enum":["test","bluesky","mastodon","x","linkedin","linkedin_page","facebook_page","instagram_fb","instagram_ig","threads","tiktok","youtube","pinterest"]},"account":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"avatarUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","reconnect","over_limit"]}},"required":["handle","displayName","avatarUrl","status"],"additionalProperties":false},"text":{"type":["string","null"]},"mediaIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"sentText":{"type":["string","null"]},"sentMedia":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","gif","video"]},"thumbUrl":{"type":["string","null"]},"url":{"type":["string","null"]},"width":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"durationMs":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"altText":{"type":"string"}},"required":["id","kind","thumbUrl","url","width","height","durationMs","altText"],"additionalProperties":false}},{"type":"null"}]},"options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"status":{"type":"string","enum":["draft","scheduled","queued","publishing","published","failed","needs_review","paused","missed"]},"statusReason":{"type":["string","null"]},"scheduledAt":{"type":["string","null"]},"local":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"},{"type":"null"}]},"fromQueue":{"type":"boolean"},"publishedAt":{"type":["string","null"]},"url":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":["string","null"]},"retryable":{"type":"boolean"}},"required":["code","message","detail","retryable"],"additionalProperties":false},{"type":"null"}]},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canDelete":{"type":"boolean"},"personConfirmedAt":{"type":["string","null"]}},"required":["id","accountId","provider","account","text","mediaIds","sentText","options","status","statusReason","scheduledAt","local","fromQueue","publishedAt","url","error","revision","canDelete"],"additionalProperties":false}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","text","media","coverMs","source","appId","externalRef","newerVersion","author","state","summary","scheduledAt","local","timezone","targets","createdAt","updatedAt"],"additionalProperties":false},"ApiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display":{"type":"string"},"createdBy":{"type":["string","null"]},"lastUsedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"kind":{"type":"string","enum":["workspace","integration","cli"]},"scopes":{"anyOf":[{"type":"array","items":{"type":"string","enum":["media:write","posts:draft"]}},{"type":"null"}]},"appId":{"type":["string","null"]},"deviceName":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["id","name","display","createdBy","lastUsedAt","createdAt"],"additionalProperties":false}}}}