{"openapi":"3.1.0","info":{"title":"ShowBits API","version":"1","description":"The REST API of ShowBits (docs/api.md). Changes within /v1 are additive."},"servers":[{"url":"https://app.showbits.ai/api"}],"components":{"securitySchemes":{"token":{"type":"http","scheme":"bearer","description":"A personal API token (sbk_…) from Settings → API. It acts as its person in its workspace, within its scopes."}},"schemas":{"Account":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"workspaces":{"type":"array","items":{"$ref":"#/components/schemas/WorkspaceSummary"},"description":"The token's workspace"},"token":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","episodes:read","episodes:write","clips:read","clips:write","clips:approve","schedule:read","schedule:write","posts:publish","ai:run","brand:read","brand:write","storage:read","integrations:read","integrations:write","team:read","team:write","settings:read","settings:write","organization:read","organization:write","audit:read","usage:read","webhooks:read","webhooks:write","library:read"]}},"expiresAt":{"type":"string","format":"date-time"}},"required":["id","scopes","expiresAt"]}},"required":["name","email","workspaces","token"]},"WorkspaceSummary":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"slug":{"type":"string"},"name":{"type":"string"}},"required":["id","slug","name"]},"Problem":{"type":"object","properties":{"type":{"type":"string","example":"https://app.showbits.ai/problems/scope"},"status":{"type":"integer"},"title":{"type":"string"},"detail":{"type":"string"},"reason":{"type":"string","description":"The refusal's reason, stable across versions (e.g. scope, notFound, quota)"}},"required":["type","status","title"]},"Installation":{"type":"object","properties":{"mode":{"type":"string","enum":["cloud","onprem"]},"airGapped":{"type":"boolean"},"uploads":{"type":"boolean","description":"Direct uploads into the media store are possible"}},"required":["mode","airGapped","uploads"]},"Workspace":{"allOf":[{"$ref":"#/components/schemas/WorkspaceSummary"},{"type":"object","properties":{"organization":{"$ref":"#/components/schemas/Organization"}},"required":["organization"]}]},"Organization":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"name":{"type":"string"},"plan":{"type":"string","enum":["hobby","creator","business","enterprise","onprem"]},"trialEndsAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","plan","trialEndsAt"]},"Membership":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"name":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["admin","cvd","editor","social"]},"orgRole":{"type":["string","null"],"enum":["owner","admin",null]}},"required":["id","name","email","role","orgRole"]},"organization":{"$ref":"#/components/schemas/Organization"}},"required":["user","organization"]},"Show":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"name":{"type":"string"},"kind":{"type":"string","enum":["tv","podcast"]},"embargoRule":{"$ref":"#/components/schemas/EmbargoRule"}},"required":["id","name","kind","embargoRule"]},"EmbargoRule":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["none"]}},"required":["kind"]},{"type":"object","properties":{"kind":{"type":"string","enum":["weekly"]},"weekday":{"type":"integer","description":"1 = Monday … 7 = Sunday"},"time":{"type":"string","example":"06:00"}},"required":["kind","weekday","time"]},{"type":"object","properties":{"kind":{"type":"string","enum":["after"]},"hours":{"type":"integer"}},"required":["kind","hours"]},{"type":"null"}]},"EpisodePage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EpisodeSummary"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"EpisodeSummary":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"showId":{"type":"string","description":"UUID"},"showName":{"type":"string"},"title":{"type":"string"},"durationSec":{"type":"number"},"status":{"type":"string","enum":["uploading","processing","ready","published"]},"progress":{"type":["number","null"],"description":"0–100 while uploading or processing"},"embargoUntil":{"type":["string","null"],"format":"date-time"},"embargoManual":{"type":"boolean"},"highlightCount":{"type":"integer"},"clipCount":{"type":"integer"},"processingError":{"type":["string","null"],"enum":["source","media","transcription","failed",null]},"analysisSkipped":{"type":["string","null"],"enum":["noAi","failed","quota",null]}},"required":["id","showId","showName","title","durationSec","status","progress","embargoUntil","embargoManual","highlightCount","clipCount","processingError","analysisSkipped"]},"Episode":{"allOf":[{"$ref":"#/components/schemas/EpisodeSummary"},{"type":"object","properties":{"fps":{"type":"number"},"format":{"type":["string","null"],"enum":["talk","reality","livestream","broll",null]},"formatConfidence":{"type":["number","null"]},"formatByEditor":{"type":"boolean"},"analysisCompletedAt":{"type":["string","null"],"format":"date-time"},"brandKitId":{"type":["string","null"],"description":"UUID"},"sourceProvider":{"type":["string","null"],"enum":["googleDrive","oneDrive","box","dropbox","mam",null]},"uploaded":{"type":"boolean"},"ruleEmbargoUntil":{"type":["string","null"],"format":"date-time"},"link":{"type":["string","null"]},"language":{"type":["string","null"],"description":"BCP 47, as the transcription detected it"}},"required":["fps","format","formatConfidence","formatByEditor","analysisCompletedAt","brandKitId","sourceProvider","uploaded","ruleEmbargoUntil","link","language"]}]},"TranscriptLine":{"type":"object","properties":{"startSec":{"type":"number"},"speaker":{"type":"string","enum":["host","guest"]},"voice":{"type":["integer","null"]},"text":{"type":"string"},"highlight":{"type":"boolean"}},"required":["startSec","speaker","voice","text","highlight"]},"ClipPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ClipSummary"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"ClipSummary":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"episodeId":{"type":"string","description":"UUID"},"title":{"type":"string"},"caption":{"type":"string"},"hookScore":{"type":"number"},"startSec":{"type":"number"},"durationSec":{"type":"number"},"subject":{"type":"string","enum":["center","left","right"]},"status":{"type":"string","enum":["review","approved","scheduled","published","rejected"]},"kind":{"type":"string","enum":["highlight","meme","quote"]},"quote":{"$ref":"#/components/schemas/QuoteCard"},"approval":{"type":"object","properties":{"stage":{"type":"integer"},"stages":{"type":"integer"},"requestedBy":{"type":["string","null"]}},"required":["stage","stages","requestedBy"]},"channels":{"type":"array","items":{"type":"string","enum":["youtube","instagram","facebook","tiktok","linkedin","x"]}},"thumbnailHeadline":{"type":["string","null"]},"video":{"$ref":"#/components/schemas/MediaState"},"thumbnail":{"$ref":"#/components/schemas/MediaState"},"subtitled":{"type":"boolean"}},"required":["id","episodeId","title","caption","hookScore","startSec","durationSec","subject","status","kind","quote","approval","channels","thumbnailHeadline","video","thumbnail","subtitled"]},"QuoteCard":{"type":["object","null"],"properties":{"said":{"type":"string"},"emphasis":{"type":"array","items":{"type":"string"}},"name":{"type":["string","null"]},"speaker":{"type":["string","null"]},"template":{"type":["string","null"],"enum":["plain","gradient","image","still",null]},"tight":{"type":"boolean"},"edited":{"type":"boolean"}},"required":["said","emphasis","name","speaker","template","tight","edited"]},"MediaState":{"oneOf":[{"type":"object","properties":{"state":{"type":"string","enum":["ready"]}},"required":["state"]},{"type":"object","properties":{"state":{"type":"string","enum":["pending"]}},"required":["state"]},{"type":"object","properties":{"state":{"type":"string","enum":["failed"]},"reason":{"type":"string","enum":["source","media"]}},"required":["state","reason"]},{"type":"object","properties":{"state":{"type":"string","enum":["none"]}},"required":["state"]}]},"Clip":{"allOf":[{"$ref":"#/components/schemas/ClipSummary"},{"type":"object","properties":{"settings":{"type":"object","properties":{"format":{"type":"string","enum":["9x16","4x5","1x1","16x9"]},"subtitleStyle":{"type":"string","enum":["clean","marker","bold","shadow"]},"reframe":{"type":"boolean"},"subtitleLanguage":{"type":["string","null"]}},"required":["format","subtitleStyle","reframe","subtitleLanguage"]},"copy":{"type":"object","properties":{"youtube":{"type":"string"},"instagram":{"type":"string"},"facebook":{"type":"string"},"tiktok":{"type":"string"},"linkedin":{"type":"string"},"x":{"type":"string"}}},"hashtags":{"type":"array","items":{"type":"string"}},"channelHashtags":{"type":"object","properties":{"youtube":{"type":"array","items":{"type":"string"}},"instagram":{"type":"array","items":{"type":"string"}},"facebook":{"type":"array","items":{"type":"string"}},"tiktok":{"type":"array","items":{"type":"string"}},"linkedin":{"type":"array","items":{"type":"string"}},"x":{"type":"array","items":{"type":"string"}}}},"postInSync":{"type":"boolean"},"captionTranslations":{"type":"object","additionalProperties":{"type":"string"}}},"required":["settings","copy","hashtags","channelHashtags","postInSync","captionTranslations"]}]},"Languages":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string"}}},"required":["data"]},"Post":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"clipId":{"type":"string","description":"UUID"},"clipTitle":{"type":"string"},"clipStatus":{"type":"string","enum":["review","approved","scheduled","published","rejected"]},"channel":{"type":"string","enum":["youtube","instagram","facebook","tiktok","linkedin","x"]},"publishAt":{"type":"string","format":"date-time"},"publishedAt":{"type":["string","null"],"format":"date-time"},"delivery":{"type":["object","null"],"properties":{"state":{"type":"string","enum":["ready","sending","processing","failed"]},"error":{"type":"string"},"note":{"type":"string","enum":["quota"]}},"required":["state"],"description":"Posting through the platform; null: a post by hand"},"youtubeOptions":{"$ref":"#/components/schemas/YouTubeSettings"},"postUrl":{"type":["string","null"]},"removal":{"type":["object","null"],"properties":{"state":{"type":"string","enum":["removing","failed"]},"error":{"type":"string"}},"required":["state"]},"comments":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["first","followup"]},"dueAt":{"type":"string","format":"date-time"},"sentAt":{"type":["string","null"],"format":"date-time"},"error":{"type":["string","null"]}},"required":["kind","dueAt","sentAt","error"]}}},"required":["id","clipId","clipTitle","clipStatus","channel","publishAt","publishedAt","delivery","youtubeOptions","postUrl","removal"]},"YouTubeSettings":{"type":["object","null"],"properties":{"privacy":{"type":"string","enum":["public","unlisted","private"]},"madeForKids":{"type":"boolean"},"synthetic":{"type":"boolean"}},"required":["privacy","madeForKids","synthetic"]},"Channels":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string","enum":["youtube","instagram","facebook","tiktok","linkedin","x"]}}},"required":["data"]},"Usage":{"type":"object","properties":{"periodStart":{"type":"string","format":"date-time"},"periodEnd":{"type":"string","format":"date-time"},"inputMinutes":{"type":"object","properties":{"used":{"type":"number"},"included":{"type":"number"}},"required":["used","included"]},"outputMinutes":{"type":"object","properties":{"used":{"type":"number"},"included":{"type":"number"}},"required":["used","included"]},"credits":{"type":["object","null"],"properties":{"remaining":{"type":"number"},"purchased":{"type":"number"},"expiresAt":{"type":"string","format":"date-time"}},"required":["remaining","purchased","expiresAt"]}},"required":["periodStart","periodEnd","inputMinutes","outputMinutes","credits"]},"AuditEvent":{"type":"object","properties":{"id":{"type":"string"},"at":{"type":"string","format":"date-time"},"actor":{"type":["string","null"]},"action":{"type":"string"},"target":{"type":"string"},"params":{"type":"object","additionalProperties":{}},"viaToken":{"type":"string","description":"The API token it was done through"}},"required":["id","at","actor","action","target"]},"EmbargoResult":{"type":"object","properties":{"embargoUntil":{"type":["string","null"],"format":"date-time"},"moved":{"type":"integer","description":"Posts moved to the new end"}},"required":["embargoUntil","moved"]},"UploadTicket":{"type":"object","properties":{"episodeId":{"type":"string","description":"UUID"},"title":{"type":"string"},"partSize":{"type":"integer"},"partCount":{"type":"integer"}},"required":["episodeId","title","partSize","partCount"],"description":"Send partCount parts of partSize bytes (the last one smaller) to the signed URLs, then complete."},"PartUrls":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"partNumber":{"type":"integer"},"url":{"type":"string"}},"required":["partNumber","url"]}}},"required":["data"]},"StoredParts":{"type":"object","properties":{"data":{"type":"array","items":{"type":"integer"}}},"required":["data"]},"StorageListing":{"type":"object","properties":{"provider":{"type":"string","enum":["googleDrive","oneDrive","box","dropbox","mam"]},"account":{"type":["string","null"]},"view":{"type":"string","enum":["root","shared","folder","search"]},"folder":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"parentId":{"type":["string","null"]}},"required":["id","name","parentId"]},"root":{"type":"string"},"hasSharedView":{"type":"boolean"},"importFolder":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"isFolder":{"type":"boolean"},"size":{"type":["number","null"]},"modifiedAt":{"type":["string","null"],"format":"date-time"},"durationSec":{"type":["number","null"]},"episodeId":{"type":["string","null"],"description":"The episode already imported from this file"}},"required":["id","name","isFolder","size","modifiedAt","durationSec","episodeId"]}},"nextPage":{"type":["string","null"]}},"required":["provider","account","view","folder","root","hasSharedView","importFolder","entries","nextPage"]},"Imported":{"type":"object","properties":{"episodeId":{"type":"string","description":"UUID"},"title":{"type":"string"}},"required":["episodeId","title"]},"WatchFolder":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"provider":{"type":"string","enum":["googleDrive","oneDrive","box","dropbox","mam"]},"folderId":{"type":"string"},"folderName":{"type":"string"},"show":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"name":{"type":"string"}},"required":["id","name"],"description":"New episodes belong to this show"},"createdAt":{"type":"string","format":"date-time"},"checkedAt":{"type":["string","null"],"format":"date-time","description":"ShowBits' last look (every two minutes)"},"error":{"type":["string","null"],"enum":["reconnect","notFound","tooMany","failed",null],"description":"Why the last look failed"},"waiting":{"type":"integer","description":"New files still uploading: imported once their size stayed the same for ten minutes"},"held":{"type":"integer","description":"Files ready but waiting for input minutes"},"lastImportAt":{"type":["string","null"],"format":"date-time"}},"required":["id","provider","folderId","folderName","show","createdAt","checkedAt","error","waiting","held","lastImportAt"]},"ApprovalOutcome":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["approved"]}},"required":["status"]},{"type":"object","properties":{"status":{"type":"string","enum":["forwarded"]},"stage":{"type":"integer"},"role":{"type":"string","enum":["admin","cvd","editor","social"]}},"required":["status","stage","role"]}]},"Count":{"type":"object","properties":{"count":{"type":"integer"}},"required":["count"]},"AiStatus":{"type":"object","properties":{"copy":{"$ref":"#/components/schemas/AiRoute"},"headline":{"$ref":"#/components/schemas/AiRoute"},"translate":{"$ref":"#/components/schemas/AiRoute"},"analysis":{"$ref":"#/components/schemas/AiRoute"},"highlights":{"$ref":"#/components/schemas/AiRoute"}},"required":["copy","headline","translate","analysis","highlights"]},"AiRoute":{"type":["object","null"],"properties":{"provider":{"type":"string"},"model":{"type":"string"},"byok":{"type":"boolean","description":"The organisation's own key (else ShowBits' keys and credits)"}},"required":["provider","model","byok"]},"CopySuggestions":{"type":"object","properties":{"copy":{"type":"object","properties":{"youtube":{"type":"string"},"instagram":{"type":"string"},"facebook":{"type":"string"},"tiktok":{"type":"string"},"linkedin":{"type":"string"},"x":{"type":"string"}}},"hashtags":{"type":"array","items":{"type":"string"}},"channelHashtags":{"type":"object","properties":{"youtube":{"type":"array","items":{"type":"string"}},"instagram":{"type":"array","items":{"type":"string"}},"facebook":{"type":"array","items":{"type":"string"}},"tiktok":{"type":"array","items":{"type":"string"}},"linkedin":{"type":"array","items":{"type":"string"}},"x":{"type":"array","items":{"type":"string"}}}},"issues":{"type":"object","properties":{"youtube":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"n":{"type":"number"},"limit":{"type":"number"},"term":{"type":"string"},"use":{"type":"string"}},"required":["code"]}},"instagram":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"n":{"type":"number"},"limit":{"type":"number"},"term":{"type":"string"},"use":{"type":"string"}},"required":["code"]}},"facebook":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"n":{"type":"number"},"limit":{"type":"number"},"term":{"type":"string"},"use":{"type":"string"}},"required":["code"]}},"tiktok":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"n":{"type":"number"},"limit":{"type":"number"},"term":{"type":"string"},"use":{"type":"string"}},"required":["code"]}},"linkedin":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"n":{"type":"number"},"limit":{"type":"number"},"term":{"type":"string"},"use":{"type":"string"}},"required":["code"]}},"x":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"n":{"type":"number"},"limit":{"type":"number"},"term":{"type":"string"},"use":{"type":"string"}},"required":["code"]}}}},"by":{"$ref":"#/components/schemas/AiRoute"}},"required":["copy","hashtags","channelHashtags","issues","by"]},"Translation":{"type":"object","properties":{"text":{"type":"string"},"by":{"$ref":"#/components/schemas/AiRoute"}},"required":["text","by"]},"Headlines":{"type":"object","properties":{"count":{"type":"integer"},"by":{"$ref":"#/components/schemas/AiRoute"}},"required":["count","by"]},"Analysis":{"type":"object","properties":{"format":{"type":"string","enum":["talk","reality","livestream","broll"]},"highlights":{"type":"integer"},"memes":{"type":"integer"},"clips":{"type":"integer"},"quotes":{"type":"integer"},"by":{"$ref":"#/components/schemas/AiRoute"}},"required":["format","highlights","memes","clips","quotes","by"]},"QuoteSearch":{"type":"object","properties":{"quotes":{"type":"integer"},"by":{"$ref":"#/components/schemas/AiRoute"}},"required":["quotes","by"]},"PostCount":{"type":"object","properties":{"posts":{"type":"integer"}},"required":["posts"]},"Removal":{"type":"object","properties":{"state":{"type":"string","enum":["removing","removed"]}},"required":["state"]},"BrandKit":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"name":{"type":"string"},"primary":{"type":"string"},"accent":{"type":"string"},"headingFont":{"type":"string"},"bodyFont":{"type":"string"},"subtitleStyle":{"type":"string","enum":["clean","marker","bold","shadow"]},"tone":{"type":"string"},"showCount":{"type":"integer"},"hasLogo":{"type":"boolean"},"ownFont":{"type":["object","null"],"properties":{"name":{"type":"string"}},"required":["name"]},"logoInVideo":{"type":"boolean"},"logoPlacement":{"type":"object","properties":{"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0.04,"maximum":0.6},"opacity":{"type":"number","minimum":0.1,"maximum":1}},"required":["x","y","width","opacity"]},"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0.04,"maximum":0.6},"opacity":{"type":"number","minimum":0.1,"maximum":1}},"required":["x","y","width","opacity"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0.04,"maximum":0.6},"opacity":{"type":"number","minimum":0.1,"maximum":1}},"required":["x","y","width","opacity"]},"16x9":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0.04,"maximum":0.6},"opacity":{"type":"number","minimum":0.1,"maximum":1}},"required":["x","y","width","opacity"]}},"required":["9x16","4x5","1x1","16x9"]},"subtitleTemplate":{"type":"object","properties":{"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"outline":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"highlight":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"shadow":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"align":{"type":"string","enum":["left","center","right"]},"bottom":{"type":"object","properties":{"9x16":{"type":"number","minimum":0.03,"maximum":0.75},"4x5":{"type":"number","minimum":0.03,"maximum":0.75},"1x1":{"type":"number","minimum":0.03,"maximum":0.75},"16x9":{"type":"number","minimum":0.03,"maximum":0.75}},"required":["9x16","4x5","1x1","16x9"]}},"required":["text","outline","highlight","shadow","align","bottom"]},"cardTemplate":{"type":["object","null"],"properties":{"background":{"type":"object","properties":{"kind":{"type":"string","enum":["plain","gradient","image","still"]},"color":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"gradient":{"type":"object","properties":{"from":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"to":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"angle":{"type":"integer","minimum":0,"maximum":359}},"required":["from","to","angle"]},"shade":{"type":"object","properties":{"mode":{"type":"string","enum":["none","bottom","top","full"]},"strength":{"type":"number","minimum":0,"maximum":1},"color":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"}},"required":["mode","strength","color"]},"crop":{"type":"object","properties":{"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"zoom":{"type":"number","minimum":1,"maximum":3}},"required":["x","y","zoom"]},"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"zoom":{"type":"number","minimum":1,"maximum":3}},"required":["x","y","zoom"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"zoom":{"type":"number","minimum":1,"maximum":3}},"required":["x","y","zoom"]}},"required":["4x5","9x16","1x1"]}},"required":["kind","color","gradient","shade","crop"]},"quote":{"type":"object","properties":{"font":{"type":"string","enum":["heading","body"]},"weight":{"anyOf":[{"type":"number","enum":[400]},{"type":"number","enum":[600]},{"type":"number","enum":[800]}]},"style":{"type":"string","enum":["clean","marker","bold","shadow"]},"text":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"outline":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"shadow":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"align":{"type":"string","enum":["left","center","right"]},"rotate":{"type":"number","minimum":-90,"maximum":90},"highlight":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"valign":{"type":"string","enum":["top","center","bottom"]},"mark":{"type":"boolean"},"markSize":{"type":"number","minimum":0.06,"maximum":0.3},"place":{"type":"object","properties":{"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.2,"maximum":1},"h":{"type":"number","minimum":0.12,"maximum":1}},"required":["x","y","w","h"]},"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.2,"maximum":1},"h":{"type":"number","minimum":0.12,"maximum":1}},"required":["x","y","w","h"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.2,"maximum":1},"h":{"type":"number","minimum":0.12,"maximum":1}},"required":["x","y","w","h"]}},"required":["4x5","9x16","1x1"]}},"required":["font","weight","style","text","outline","shadow","align","rotate","highlight","valign","mark","markSize","place"]},"speaker":{"type":"object","properties":{"font":{"type":"string","enum":["heading","body"]},"weight":{"anyOf":[{"type":"number","enum":[400]},{"type":"number","enum":[600]},{"type":"number","enum":[800]}]},"style":{"type":"string","enum":["clean","marker","bold","shadow"]},"text":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"outline":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"shadow":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"align":{"type":"string","enum":["left","center","right"]},"rotate":{"type":"number","minimum":-90,"maximum":90},"box":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"corners":{"type":"string","enum":["round","square"],"default":"round"},"place":{"type":"object","properties":{"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.15,"maximum":1},"size":{"type":"number","minimum":0.02,"maximum":0.07}},"required":["x","y","w","size"]},"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.15,"maximum":1},"size":{"type":"number","minimum":0.02,"maximum":0.07}},"required":["x","y","w","size"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.15,"maximum":1},"size":{"type":"number","minimum":0.02,"maximum":0.07}},"required":["x","y","w","size"]}},"required":["4x5","9x16","1x1"]}},"required":["font","weight","style","text","outline","shadow","align","rotate","box","place"]},"logo":{"type":"object","properties":{"on":{"type":"boolean"},"place":{"type":"object","properties":{"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.04,"maximum":0.6},"h":{"type":"number","minimum":0.02,"maximum":0.6}},"required":["x","y","w","h"]},"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.04,"maximum":0.6},"h":{"type":"number","minimum":0.02,"maximum":0.6}},"required":["x","y","w","h"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.04,"maximum":0.6},"h":{"type":"number","minimum":0.02,"maximum":0.6}},"required":["x","y","w","h"]}},"required":["4x5","9x16","1x1"]}},"required":["on","place"]}},"required":["background","quote","speaker","logo"]},"hasCardImage":{"type":"boolean"},"listenUrl":{"type":["string","null"]},"linkedin":{"type":"object","properties":{"mentions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"}},"required":["name","id"]}},"firstComment":{"type":"boolean"},"followUp":{"type":"boolean"}},"required":["mentions","firstComment","followUp"]},"youtube":{"$ref":"#/components/schemas/YouTubeSettings"}},"required":["id","name","primary","accent","headingFont","bodyFont","subtitleStyle","tone","showCount","hasLogo","ownFont","logoInVideo","logoPlacement","subtitleTemplate","cardTemplate","hasCardImage","listenUrl","linkedin","youtube"]},"Restyle":{"type":"object","properties":{"clips":{"type":"integer"},"cards":{"type":"integer"},"minutes":{"type":"number"}},"required":["clips","cards","minutes"]},"Whitelabel":{"type":"object","properties":{"enabled":{"type":"boolean"},"domain":{"type":"string"},"emailSender":{"type":"string"},"themeBrandKitId":{"type":["string","null"],"description":"UUID"}},"required":["enabled","domain","emailSender","themeBrandKitId"]},"Stats":{"type":"object","properties":{"clipsThisWeek":{"type":"integer"},"hoursSaved":{"type":"number"}},"required":["clipsThisWeek","hoursSaved"]},"Member":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"name":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["admin","cvd","editor","social"]},"pending":{"type":"boolean","description":"Invited, not accepted yet"}},"required":["id","name","email","role","pending"]},"Seats":{"type":"object","properties":{"plan":{"type":"string","enum":["hobby","creator","business","enterprise","onprem"]},"used":{"type":"integer"},"limit":{"type":["integer","null"]}},"required":["plan","used","limit"]},"Integration":{"type":"object","properties":{"id":{"type":"string"},"connected":{"type":"boolean"},"accounts":{"type":"integer"},"folder":{"type":"string"},"account":{"type":"string"},"accountKind":{"type":"string","enum":["person","organization"]},"isDefault":{"type":"boolean"},"model":{"type":"string"},"models":{"type":"array","items":{"type":"string"}},"failure":{"type":"object","properties":{"reason":{"type":"string","enum":["key","quota"]},"since":{"type":"string","format":"date-time"}},"required":["reason","since"]},"requested":{"type":"boolean"},"removal":{"type":["object","null"],"properties":{"until":{"type":"string","format":"date-time"},"account":{"type":"string"}},"required":["until","account"]},"reconnectBy":{"type":["string","null"],"format":"date-time"}},"required":["id","connected"]},"EditorialSettings":{"type":"object","properties":{"terms":{"type":"array","items":{"type":"object","properties":{"avoid":{"type":"string"},"use":{"type":"string"}},"required":["avoid","use"]}},"blocked":{"type":"array","items":{"type":"string"}},"styleGuide":{"type":"string"},"available":{"type":"boolean","description":"The plan includes editorial rules (Business and up)"},"updatedAt":{"type":["string","null"],"format":"date-time"},"updatedBy":{"type":["string","null"]}},"required":["terms","blocked","styleGuide","available","updatedAt","updatedBy"]},"Security":{"type":"object","properties":{"sso":{"type":"boolean"},"scim":{"type":"boolean"},"embargoByDefault":{"type":"boolean"},"embargoRule":{"$ref":"#/components/schemas/EmbargoRule"}},"required":["sso","scim","embargoByDefault","embargoRule"]},"Webhook":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"paused":{"type":["string","null"],"enum":["manual","failing",null],"description":"failing: three days without a successful delivery"},"failingSince":{"type":["string","null"],"format":"date-time"},"lastSuccessAt":{"type":["string","null"],"format":"date-time"},"previousSecretUntil":{"type":["string","null"],"format":"date-time","description":"After a rotation the previous secret signs too, until then"}},"required":["id","url","events","description","createdAt","paused","failingSince","lastSuccessAt","previousSecretUntil"]},"WebhookWithSecret":{"type":"object","properties":{"webhook":{"$ref":"#/components/schemas/Webhook"},"secret":{"type":"string","description":"Shown once: sign checks with it (ShowBits-Signature)"}},"required":["webhook","secret"]},"WebhookSecret":{"type":"object","properties":{"secret":{"type":"string"}},"required":["secret"]},"WebhookDelivery":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"eventId":{"type":"string","description":"UUID"},"event":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"attempts":{"type":"integer"},"deliveredAt":{"type":["string","null"],"format":"date-time"},"givenUpAt":{"type":["string","null"],"format":"date-time"},"nextAt":{"type":["string","null"],"format":"date-time"},"lastStatus":{"type":["integer","null"]},"lastError":{"type":["string","null"]}},"required":["id","eventId","event","createdAt","attempts","deliveredAt","givenUpAt","nextAt","lastStatus","lastError"]},"Connector":{"type":"object","properties":{"id":{"type":"string","enum":["mam"],"description":"mam: the S3-compatible storage of an MAM or DAM"},"available":{"type":"boolean","description":"The plan has connectors (Enterprise, OnPremise)"},"connected":{"type":"boolean"},"account":{"type":["string","null"],"description":"bucket · host"},"delivery":{"type":["object","null"],"properties":{"folderId":{"type":"string"},"folderName":{"type":"string"},"auto":{"type":"boolean","description":"Released clips go there by themselves"}},"required":["folderId","folderName","auto"],"description":"Where released clips go; null: none"}},"required":["id","available","connected","account","delivery"]},"ConnectorDelivery":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"clip":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"title":{"type":"string"},"episodeId":{"type":"string","description":"UUID"}},"required":["id","title","episodeId"]},"target":{"type":"string","enum":["mam"]},"version":{"type":"integer","description":"Counts up with every new release or video of the clip"},"state":{"type":"string","enum":["queued","sending","delivered","failed"]},"reason":{"type":"string","enum":["released","rendered","requested"]},"attempts":{"type":"integer"},"nextAt":{"type":["string","null"],"format":"date-time"},"error":{"type":["string","null"],"enum":["reconnect","notFound","tooLarge","media","failed",null]},"location":{"type":["string","null"],"description":"s3://bucket/folder/: the clip's folder with clip.json"},"deliveredAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","clip","target","version","state","reason","attempts","nextAt","error","location","deliveredAt","updatedAt"]},"Delivered":{"type":"object","properties":{"targets":{"type":"integer","description":"How many connectors the clip goes to"}},"required":["targets"]},"LibraryPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/LibraryItem"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"LibraryItem":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"kind":{"type":"string","enum":["highlight","meme","quote"]},"title":{"type":"string"},"caption":{"type":"string","description":"What is said in the clip; the text on a quote card"},"hashtags":{"type":"array","items":{"type":"string"}},"durationSec":{"type":"number"},"format":{"type":["string","null"],"enum":["9x16","4x5","1x1","16x9",null],"description":"The video's frame; null for quote cards"},"status":{"type":"string","enum":["approved","scheduled","published"]},"releasedAt":{"type":["string","null"],"format":"date-time"},"episode":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"title":{"type":"string"},"language":{"type":["string","null"]}},"required":["id","title","language"]},"show":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"name":{"type":"string"}},"required":["id","name"]},"quote":{"type":["object","null"],"properties":{"said":{"type":"string"},"name":{"type":["string","null"]}},"required":["said","name"]},"embargoUntil":{"type":["string","null"],"format":"date-time","description":"No file leaves ShowBits before then (409 embargo)"},"version":{"type":"string","description":"Changes whenever its files change: take a new copy then"},"files":{"type":"array","items":{"$ref":"#/components/schemas/LibraryFile"}},"preview":{"type":["string","null"],"description":"A small WebP for lists, a signed link valid for an hour; null before the embargo ends; not logged as an export"}},"required":["id","kind","title","caption","hashtags","durationSec","format","status","releasedAt","episode","show","quote","embargoUntil","version","files","preview"]},"LibraryFile":{"type":"object","properties":{"variant":{"type":"string","enum":["video","16x9","9x16","4x5","1x1","motion-9x16","motion-4x5"],"description":"motion-9x16 and motion-4x5: an animated quote card's videos (added 2026-11-10)"},"contentType":{"type":"string","enum":["video/mp4","image/jpeg"]},"width":{"type":"integer"},"height":{"type":"integer"},"size":{"type":["integer","null"],"description":"Bytes, where known (a clip's video)"},"durationSec":{"type":["number","null"],"description":"Seconds, for an animated quote card's video"}},"required":["variant","contentType","width","height","size"]},"WordPressSite":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"url":{"type":"string"},"name":{"type":"string"},"connectedAt":{"type":"string","format":"date-time"},"connectedBy":{"type":["string","null"]},"pluginVersion":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"],"format":"date-time","description":"The plugin's last request (to the minute)"}},"required":["id","url","name","connectedAt","connectedBy","pluginVersion","lastSeenAt"]},"Queued":{"type":"object","properties":{"queued":{"type":"integer","description":"Pushes queued (a clip still on its way is not queued again)"}},"required":["queued"]},"WordPressPush":{"type":"object","properties":{"id":{"type":"string","description":"UUID"},"siteId":{"type":"string","description":"UUID"},"clipId":{"type":"string","description":"UUID"},"createdAt":{"type":"string","format":"date-time"},"fromSite":{"type":"boolean","description":"Picked in WordPress; otherwise pushed from ShowBits"},"state":{"type":"string","enum":["queued","delivered","imported","failed"]},"attachmentUrl":{"type":["string","null"]},"error":{"type":["string","null"]},"attempts":{"type":"integer"}},"required":["id","siteId","clipId","createdAt","fromSite","state","attachmentUrl","error","attempts"]}},"parameters":{}},"paths":{"/v1/me":{"get":{"summary":"The token's person and workspace","tags":["Account"],"security":[{"token":[]}],"description":"Any valid token.","responses":{"200":{"description":"The person","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/installation":{"get":{"summary":"This installation","tags":["Account"],"security":[{"token":[]}],"description":"Any valid token.","responses":{"200":{"description":"Cloud or OnPremise","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Installation"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces":{"get":{"summary":"The token's workspace","tags":["Workspaces"],"security":[{"token":["workspaces:read"]}],"description":"Scope `workspaces:read`.","responses":{"200":{"description":"One workspace: a token belongs to one","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WorkspaceSummary"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}":{"get":{"summary":"A workspace","tags":["Workspaces"],"security":[{"token":["workspaces:read"]}],"description":"Scope `workspaces:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"The workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/me":{"get":{"summary":"The token's person in the workspace, with their role","tags":["Workspaces"],"security":[{"token":["workspaces:read"]}],"description":"Scope `workspaces:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Role and organisation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Membership"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/shows":{"get":{"summary":"The workspace's shows","tags":["Workspaces"],"security":[{"token":["workspaces:read"]}],"description":"Scope `workspaces:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Shows","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Show"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes":{"get":{"summary":"Episodes, newest first","tags":["Episodes"],"security":[{"token":["episodes:read"]}],"description":"Scope `episodes:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":200},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["all","processing","ready","published"],"default":"all"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","maxLength":200,"description":"Words in the title"},"required":false,"description":"Words in the title","name":"q","in":"query"}],"responses":{"200":{"description":"A page of episodes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodePage"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}":{"get":{"summary":"An episode","tags":["Episodes"],"security":[{"token":["episodes:read"]}],"description":"Scope `episodes:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The episode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Episode"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"summary":"Delete an episode with its clips, posts and uploaded file","tags":["Episodes"],"security":[{"token":["episodes:write"]}],"description":"Scope `episodes:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"patch":{"summary":"Change an episode's format, link or show","tags":["Episodes"],"security":[{"token":["episodes:write"]}],"description":"Scope `episodes:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":["string","null"],"enum":["talk","reality","livestream","broll",null],"description":"What the episode is; null hands it back to the recognition"},"link":{"type":["string","null"],"maxLength":500,"description":"The episode's own link (https); null removes it"},"showId":{"type":"string","pattern":"^[\\w-]{1,64}$","description":"Another show, while the episode is uploaded or processed"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The episode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Episode"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/transcript":{"get":{"summary":"An episode's transcript","tags":["Episodes"],"security":[{"token":["episodes:read"]}],"description":"Scope `episodes:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Lines, by time","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TranscriptLine"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips":{"get":{"summary":"Clips and quote cards","tags":["Clips"],"security":[{"token":["clips:read"]}],"description":"Scope `clips:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":200},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","maxLength":64},"required":false,"name":"episodeId","in":"query"},{"schema":{"type":"string","enum":["review","approved","scheduled","published","rejected"]},"required":false,"name":"status","in":"query"}],"responses":{"200":{"description":"A page of clips","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClipPage"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}":{"get":{"summary":"A clip with its texts and settings","tags":["Clips"],"security":[{"token":["clips:read"]}],"description":"Scope `clips:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The clip","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Clip"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"patch":{"summary":"Change a clip: title, cut, format, channels, texts, hashtags, a quote card's text","description":"A new cut or format renders the video again. A released quote card changes only after it is sent for approval again (POST …/submit).\n\nScope `clips:write`.","tags":["Clips"],"security":[{"token":["clips:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"settings":{"type":"object","properties":{"format":{"type":"string","enum":["9x16","4x5","1x1","16x9"]},"subtitleStyle":{"type":"string","enum":["clean","marker","bold","shadow"]},"reframe":{"type":"boolean"},"subtitleLanguage":{"type":["string","null"],"pattern":"^[a-z]{2,3}(-[A-Z]{2})?$"}}},"channels":{"type":"array","items":{"type":"string","enum":["youtube","instagram","facebook","tiktok","linkedin","x"]},"maxItems":6},"copy":{"type":"object","properties":{"youtube":{"type":"string","maxLength":5000},"instagram":{"type":"string","maxLength":5000},"facebook":{"type":"string","maxLength":5000},"tiktok":{"type":"string","maxLength":5000},"linkedin":{"type":"string","maxLength":5000},"x":{"type":"string","maxLength":5000}}},"hashtags":{"type":"array","items":{"type":"string","minLength":2,"maxLength":100},"maxItems":30},"channelHashtags":{"type":"object","properties":{"youtube":{"type":["array","null"],"items":{"type":"string","minLength":2,"maxLength":100},"maxItems":30},"instagram":{"type":["array","null"],"items":{"type":"string","minLength":2,"maxLength":100},"maxItems":30},"facebook":{"type":["array","null"],"items":{"type":"string","minLength":2,"maxLength":100},"maxItems":30},"tiktok":{"type":["array","null"],"items":{"type":"string","minLength":2,"maxLength":100},"maxItems":30},"linkedin":{"type":["array","null"],"items":{"type":"string","minLength":2,"maxLength":100},"maxItems":30},"x":{"type":["array","null"],"items":{"type":"string","minLength":2,"maxLength":100},"maxItems":30}}},"cut":{"type":"object","properties":{"startSec":{"type":"number","minimum":0,"maximum":86400},"durationSec":{"type":"number","minimum":1,"maximum":600}},"required":["startSec","durationSec"]},"quote":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"emphasis":{"type":"array","items":{"type":"string","minLength":1,"maxLength":40},"maxItems":4},"name":{"type":["string","null"],"maxLength":60}},"required":["text","emphasis","name"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"The clip","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Clip"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"summary":"Delete a clip with its texts, approvals and planned posts","tags":["Clips"],"security":[{"token":["clips:write"]}],"description":"Scope `clips:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/video":{"get":{"summary":"The clip's video","tags":["Clips"],"security":[{"token":["clips:read"]}],"description":"Scope `clips:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"true: the link downloads the file"},"required":false,"description":"true: the link downloads the file","name":"download","in":"query"}],"responses":{"302":{"description":"Redirects to a short-lived link to the file (one hour)","headers":{"location":{"schema":{"type":"string"},"required":true}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/thumbnail":{"get":{"summary":"The clip's thumbnail, or a quote card's picture","tags":["Clips"],"security":[{"token":["clips:read"]}],"description":"Scope `clips:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"true: the link downloads the file"},"required":false,"description":"true: the link downloads the file","name":"download","in":"query"},{"schema":{"type":"string","enum":["16x9","9x16","4x5","1x1"],"default":"16x9","description":"Clips: 16x9 or the 9x16 cover; quote cards: 4x5, 9x16, 1x1"},"required":false,"description":"Clips: 16x9 or the 9x16 cover; quote cards: 4x5, 9x16, 1x1","name":"format","in":"query"}],"responses":{"302":{"description":"Redirects to a short-lived link to the file (one hour)","headers":{"location":{"schema":{"type":"string"},"required":true}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/subtitles":{"get":{"summary":"The clip's subtitles (WebVTT)","tags":["Clips"],"security":[{"token":["clips:read"]}],"description":"Scope `clips:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"302":{"description":"Redirects to a short-lived link to the file (one hour)","headers":{"location":{"schema":{"type":"string"},"required":true}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/subtitle-languages":{"get":{"summary":"Languages subtitles can be translated into","tags":["Clips"],"security":[{"token":[]}],"description":"Any valid token.","responses":{"200":{"description":"BCP 47 codes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Languages"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/posts":{"get":{"summary":"Planned and published posts in a time range","tags":["Posts"],"security":[{"token":["schedule:read"]}],"description":"Scope `schedule:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","format":"date-time","description":"Default: 30 days ago"},"required":false,"description":"Default: 30 days ago","name":"from","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Default: 120 days after from; at most 400 days after from"},"required":false,"description":"Default: 120 days after from; at most 400 days after from","name":"to","in":"query"}],"responses":{"200":{"description":"Posts, by time","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Post"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/posts":{"get":{"summary":"A clip's posts","tags":["Posts"],"security":[{"token":["schedule:read"]}],"description":"Scope `schedule:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Posts, by time","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Post"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"put":{"summary":"Plan an approved clip on channels","description":"A channel planned already moves to its new time.\n\nScope `schedule:write`.","tags":["Posts"],"security":[{"token":["schedule:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"times":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["youtube","instagram","facebook","tiktok","linkedin","x"]},"publishAt":{"type":"string","format":"date-time"}},"required":["channel","publishAt"],"additionalProperties":false},"minItems":1,"maxItems":6},"inSync":{"type":"boolean","description":"All channels at one time (the first entry's); moving one post later moves all"}},"required":["times","inSync"],"additionalProperties":false}}}},"responses":{"200":{"description":"The clip's posts","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Post"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/channels":{"get":{"summary":"Channels ShowBits posts to by itself right now","tags":["Posts"],"security":[{"token":["schedule:read"]}],"description":"Scope `schedule:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Connected channels","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Channels"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/usage":{"get":{"summary":"Minutes used and included this period","tags":["Usage"],"security":[{"token":["usage:read"]}],"description":"Scope `usage:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Usage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Usage"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/audit-events":{"get":{"summary":"The audit log, newest first (workspace admins)","tags":["Usage"],"security":[{"token":["audit:read"]}],"description":"Scope `audit:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Events","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AuditEvent"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/resume":{"post":{"summary":"Take up an episode the quota stopped","tags":["Episodes"],"security":[{"token":["episodes:write"]}],"description":"Scope `episodes:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The episode, processing again","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Episode"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/poster":{"get":{"summary":"The episode's small still","tags":["Episodes"],"security":[{"token":["episodes:read"]}],"description":"Scope `episodes:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"WebP","content":{"image/webp":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/embargo":{"put":{"summary":"Set, change or lift an episode's embargo (admins and duty editors)","tags":["Episodes"],"security":[{"token":["episodes:write"]}],"description":"Scope `episodes:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"until":{"type":["string","null"],"format":"date-time","description":"The new end; null lifts the embargo"},"rule":{"type":"boolean","enum":[true],"description":"Apply the show's rule again"},"movePosts":{"type":"boolean","default":false,"description":"Move posts planned before the new end to it (else 409 postsBefore)"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The embargo now","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbargoResult"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/posts":{"get":{"summary":"The episode's open posts planned before a time","tags":["Episodes"],"security":[{"token":["schedule:read"]}],"description":"Scope `schedule:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","format":"date-time","description":"A possible new embargo end"},"required":true,"description":"A possible new embargo end","name":"until","in":"query"}],"responses":{"200":{"description":"Posts, by time","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Post"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/shows/{id}/embargo-rule":{"put":{"summary":"The embargo rule of a show's new episodes (workspace admins)","tags":["Workspaces"],"security":[{"token":["settings:write"]}],"description":"Scope `settings:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rule":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["none"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["weekly"]},"weekday":{"type":"integer","minimum":1,"maximum":7},"time":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["kind","weekday","time"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["after"]},"hours":{"type":"integer","minimum":1,"maximum":720}},"required":["kind","hours"],"additionalProperties":false},{"type":"null"}],"description":"null: the organisation's default"}},"required":["rule"],"additionalProperties":false}}}},"responses":{"200":{"description":"The show","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Show"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/uploads":{"post":{"summary":"Start uploading a video or audio file","description":"Creates the episode and the bucket's multipart upload. Then sign the parts, PUT each to its URL, and complete.\n\nScope `episodes:write`.","tags":["Uploads"],"security":[{"token":["episodes:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":500},"size":{"type":"integer","exclusiveMinimum":0},"type":{"type":"string","maxLength":200}},"required":["name","size","type"]}}}},"responses":{"201":{"description":"Started","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadTicket"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/uploads/{id}/parts":{"post":{"summary":"Signed URLs for parts (valid for an hour)","tags":["Uploads"],"security":[{"token":["episodes:write"]}],"description":"Scope `episodes:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"integer","minimum":1,"maximum":10000},"minItems":1,"maxItems":50},"progress":{"type":["number","null"],"minimum":0,"maximum":100,"default":null}},"required":["parts"],"additionalProperties":false}}}},"responses":{"200":{"description":"One URL per part: PUT the part's bytes to it","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartUrls"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"summary":"Parts the bucket has (to continue an interrupted upload)","tags":["Uploads"],"security":[{"token":["episodes:write"]}],"description":"Scope `episodes:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Part numbers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoredParts"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/uploads/{id}/complete":{"post":{"summary":"All parts are there: assemble the file and start processing","tags":["Uploads"],"security":[{"token":["episodes:write"]}],"description":"Scope `episodes:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The episode at 100 %; the worker takes it up and moves it to processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Episode"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/storage/{provider}/files":{"get":{"summary":"Folders and video or audio files in a connected storage","tags":["Uploads"],"security":[{"token":["storage:read"]}],"description":"Scope `storage:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","enum":["googleDrive","oneDrive","box","dropbox","mam"]},"required":true,"name":"provider","in":"path"},{"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,200}$"},"required":false,"name":"folder","in":"query"},{"schema":{"type":"string","enum":["root","shared"]},"required":false,"name":"view","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":200},"required":false,"name":"search","in":"query"},{"schema":{"type":"string","maxLength":2000,"description":"nextPage of the previous answer"},"required":false,"description":"nextPage of the previous answer","name":"page","in":"query"}],"responses":{"200":{"description":"A listing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageListing"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/imports":{"post":{"summary":"A new episode from a file in a connected storage (read in place)","tags":["Uploads"],"security":[{"token":["episodes:write"]}],"description":"Scope `episodes:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["googleDrive","oneDrive","box","dropbox","mam"]},"fileId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,200}$"}},"required":["provider","fileId"],"additionalProperties":false}}}},"responses":{"201":{"description":"The new episode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Imported"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/storage/{provider}/import-folder":{"put":{"summary":"The folder imports start from (admins)","tags":["Uploads"],"security":[{"token":["settings:write"]}],"description":"Scope `settings:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","enum":["googleDrive","oneDrive","box","dropbox","mam"]},"required":true,"name":"provider","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":["string","null"],"pattern":"^[A-Za-z0-9_-]{1,200}$"}},"required":["folderId"],"additionalProperties":false}}}},"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/watch-folders":{"get":{"summary":"Folders watched for new files","tags":["Uploads"],"security":[{"token":["storage:read"]}],"description":"Scope `storage:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Watched folders","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WatchFolder"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"post":{"summary":"Watch a folder (admins)","description":"Files in the folder now stay as they are; every video or audio file that arrives later becomes an episode of the show once its size has stayed the same for ten minutes. Only the folder itself, not its subfolders. At most 10 per workspace.\n\nScope `settings:write`.","tags":["Uploads"],"security":[{"token":["settings:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["googleDrive","oneDrive","box","dropbox","mam"]},"folderId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,200}$"},"showId":{"type":["string","null"],"minLength":1,"maxLength":64,"default":null,"description":"The show new episodes belong to; null: the workspace's first"}},"required":["provider","folderId"],"additionalProperties":false}}}},"responses":{"201":{"description":"The watched folder","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchFolder"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/watch-folders/{id}":{"delete":{"summary":"Stop watching a folder (admins)","tags":["Uploads"],"security":[{"token":["settings:write"]}],"description":"Scope `settings:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/submit":{"post":{"summary":"Send a clip into the first approval step","tags":["Clips"],"security":[{"token":["clips:write"]}],"description":"Scope `clips:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The clip, in review","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Clip"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/approve":{"post":{"summary":"Approve one step","description":"The last step releases the clip for planning and posting. In the token's person's name; the audit log names the token.\n\nScope `clips:approve`.","tags":["Approval"],"security":[{"token":["clips:approve"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","maxLength":2000,"description":"Shown in the approval history"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Released, or forwarded to the next step","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalOutcome"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/reject":{"post":{"summary":"Send a clip back for changes","tags":["Approval"],"security":[{"token":["clips:approve"]}],"description":"Scope `clips:approve`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","maxLength":2000,"description":"Shown in the approval history"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The clip","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Clip"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/approve-all":{"post":{"summary":"Move every clip of an episode in review one approval step forward","tags":["Approval"],"security":[{"token":["clips:approve"]}],"description":"Scope `clips:approve`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"How many moved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Count"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/still":{"get":{"summary":"The clip's clean still, without headline","tags":["Clips"],"security":[{"token":["clips:read"]}],"description":"Scope `clips:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"WebP","content":{"image/webp":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/ai/status":{"get":{"summary":"Who would run each AI task now","tags":["AI"],"security":[{"token":["integrations:read"]}],"description":"Scope `integrations:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"A provider and model per task, or null","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiStatus"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/copy-suggestions":{"post":{"summary":"Texts and hashtags per channel, in the brand's voice (nothing is saved)","tags":["AI"],"security":[{"token":["ai:run"]}],"description":"Scope `ai:run`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"channels":{"type":"array","items":{"type":"string","enum":["youtube","instagram","facebook","tiktok","linkedin","x"]},"minItems":1,"maxItems":6,"description":"Default: the clip's channels"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Suggestions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CopySuggestions"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/translations":{"post":{"summary":"Translate the clip's subtitle and store it for that language","tags":["AI"],"security":[{"token":["ai:run"]}],"description":"Scope `ai:run`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Z]{2})?$","description":"BCP 47, one of GET /v1/subtitle-languages"}},"required":["language"],"additionalProperties":false}}}},"responses":{"200":{"description":"The translation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Translation"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/headlines":{"post":{"summary":"Thumbnail headlines for the episode's first clips (stored)","tags":["AI"],"security":[{"token":["ai:run"]}],"description":"Scope `ai:run`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"How many","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Headlines"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/analysis":{"post":{"summary":"Analyse the transcript again: format, highlights, memes, clips","tags":["AI"],"security":[{"token":["ai:run"]}],"description":"Scope `ai:run`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"What it found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analysis"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/episodes/{id}/quote-search":{"post":{"summary":"Look for quote cards in the episode","tags":["AI"],"security":[{"token":["ai:run"]}],"description":"Scope `ai:run`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"New quote cards","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteSearch"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/posts/{id}":{"delete":{"summary":"Take a planned post off the plan","tags":["Posts"],"security":[{"token":["schedule:write"]}],"description":"Scope `schedule:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"patch":{"summary":"Move a post to a new time","description":"A clip planned in sync moves all its open posts.\n\nScope `schedule:write`.","tags":["Posts"],"security":[{"token":["schedule:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"publishAt":{"type":"string","format":"date-time"}},"required":["publishAt"],"additionalProperties":false}}}},"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/posts/{id}/mark-published":{"post":{"summary":"Mark a post put online by hand as published","tags":["Posts"],"security":[{"token":["schedule:write"]}],"description":"Scope `schedule:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/posts/{id}/youtube-options":{"put":{"summary":"A YouTube post's own visibility and statements","tags":["Posts"],"security":[{"token":["schedule:write"]}],"description":"Scope `schedule:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":["object","null"],"properties":{"privacy":{"type":"string","enum":["public","unlisted","private"]},"madeForKids":{"type":"boolean"},"synthetic":{"type":"boolean"}},"required":["privacy","madeForKids","synthetic"],"additionalProperties":false,"description":"null: as the show's brand kit says"}},"required":["options"],"additionalProperties":false}}}},"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/posts/{id}/retry":{"post":{"summary":"Send a failed post again","tags":["Posts"],"security":[{"token":["schedule:write"]}],"description":"Scope `schedule:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/publish":{"post":{"summary":"Post a released clip now on connected channels","tags":["Posts"],"security":[{"token":["posts:publish"]}],"description":"Scope `posts:publish`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channels":{"type":"array","items":{"type":"string","enum":["youtube","instagram","facebook","tiktok","linkedin","x"]},"minItems":1,"maxItems":6,"description":"Connected channels (GET …/channels)"}},"required":["channels"],"additionalProperties":false}}}},"responses":{"200":{"description":"Posts under way","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCount"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/posts/{id}/remove":{"post":{"summary":"Take a published post down","description":"Where ShowBits posted it, ShowBits deletes it on the platform (removing, then removed).\n\nScope `posts:publish`.","tags":["Posts"],"security":[{"token":["posts:publish"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"here":{"type":"boolean","default":false,"description":"true: the post was deleted on the platform by hand; only the plan forgets it"}},"additionalProperties":false}}}},"responses":{"200":{"description":"State","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Removal"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/brand-kits":{"get":{"summary":"The workspace's brand kits","tags":["Brand kits"],"security":[{"token":["brand:read"]}],"description":"Scope `brand:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Brand kits","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BrandKit"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"post":{"summary":"A new brand kit (workspace admins)","tags":["Brand kits"],"security":[{"token":["brand:write"]}],"description":"Scope `brand:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"The brand kit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandKit"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/brand-kits/{id}":{"patch":{"summary":"Change a brand kit (workspace admins)","tags":["Brand kits"],"security":[{"token":["brand:write"]}],"description":"Scope `brand:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"primary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"headingFont":{"type":"string","enum":["Plus Jakarta Sans","Geist","Inter","Source Serif 4","own"]},"bodyFont":{"type":"string","enum":["Plus Jakarta Sans","Geist","Inter","Source Serif 4","own"]},"subtitleStyle":{"type":"string","enum":["clean","marker","bold","shadow"]},"tone":{"type":"string","maxLength":500},"logoInVideo":{"type":"boolean"},"logoPlacement":{"type":"object","properties":{"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0.04,"maximum":0.6},"opacity":{"type":"number","minimum":0.1,"maximum":1}},"required":["x","y","width","opacity"]},"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0.04,"maximum":0.6},"opacity":{"type":"number","minimum":0.1,"maximum":1}},"required":["x","y","width","opacity"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0.04,"maximum":0.6},"opacity":{"type":"number","minimum":0.1,"maximum":1}},"required":["x","y","width","opacity"]},"16x9":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0.04,"maximum":0.6},"opacity":{"type":"number","minimum":0.1,"maximum":1}},"required":["x","y","width","opacity"]}},"required":["9x16","4x5","1x1","16x9"]},"subtitleTemplate":{"type":"object","properties":{"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"outline":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"highlight":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"shadow":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"align":{"type":"string","enum":["left","center","right"]},"bottom":{"type":"object","properties":{"9x16":{"type":"number","minimum":0.03,"maximum":0.75},"4x5":{"type":"number","minimum":0.03,"maximum":0.75},"1x1":{"type":"number","minimum":0.03,"maximum":0.75},"16x9":{"type":"number","minimum":0.03,"maximum":0.75}},"required":["9x16","4x5","1x1","16x9"]}},"required":["text","outline","highlight","shadow","align","bottom"]},"cardTemplate":{"type":["object","null"],"properties":{"background":{"type":"object","properties":{"kind":{"type":"string","enum":["plain","gradient","image","still"]},"color":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"gradient":{"type":"object","properties":{"from":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"to":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"angle":{"type":"integer","minimum":0,"maximum":359}},"required":["from","to","angle"]},"shade":{"type":"object","properties":{"mode":{"type":"string","enum":["none","bottom","top","full"]},"strength":{"type":"number","minimum":0,"maximum":1},"color":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"}},"required":["mode","strength","color"]},"crop":{"type":"object","properties":{"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"zoom":{"type":"number","minimum":1,"maximum":3}},"required":["x","y","zoom"]},"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"zoom":{"type":"number","minimum":1,"maximum":3}},"required":["x","y","zoom"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"zoom":{"type":"number","minimum":1,"maximum":3}},"required":["x","y","zoom"]}},"required":["4x5","9x16","1x1"]}},"required":["kind","color","gradient","shade","crop"]},"quote":{"type":"object","properties":{"font":{"type":"string","enum":["heading","body"]},"weight":{"anyOf":[{"type":"number","enum":[400]},{"type":"number","enum":[600]},{"type":"number","enum":[800]}]},"style":{"type":"string","enum":["clean","marker","bold","shadow"]},"text":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"outline":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"shadow":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"align":{"type":"string","enum":["left","center","right"]},"rotate":{"type":"number","minimum":-90,"maximum":90},"highlight":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"valign":{"type":"string","enum":["top","center","bottom"]},"mark":{"type":"boolean"},"markSize":{"type":"number","minimum":0.06,"maximum":0.3},"place":{"type":"object","properties":{"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.2,"maximum":1},"h":{"type":"number","minimum":0.12,"maximum":1}},"required":["x","y","w","h"]},"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.2,"maximum":1},"h":{"type":"number","minimum":0.12,"maximum":1}},"required":["x","y","w","h"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.2,"maximum":1},"h":{"type":"number","minimum":0.12,"maximum":1}},"required":["x","y","w","h"]}},"required":["4x5","9x16","1x1"]}},"required":["font","weight","style","text","outline","shadow","align","rotate","highlight","valign","mark","markSize","place"]},"speaker":{"type":"object","properties":{"font":{"type":"string","enum":["heading","body"]},"weight":{"anyOf":[{"type":"number","enum":[400]},{"type":"number","enum":[600]},{"type":"number","enum":[800]}]},"style":{"type":"string","enum":["clean","marker","bold","shadow"]},"text":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"outline":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"shadow":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"align":{"type":"string","enum":["left","center","right"]},"rotate":{"type":"number","minimum":-90,"maximum":90},"box":{"type":["string","null"],"pattern":"^#[0-9a-fA-F]{6}$"},"corners":{"type":"string","enum":["round","square"],"default":"round"},"place":{"type":"object","properties":{"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.15,"maximum":1},"size":{"type":"number","minimum":0.02,"maximum":0.07}},"required":["x","y","w","size"]},"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.15,"maximum":1},"size":{"type":"number","minimum":0.02,"maximum":0.07}},"required":["x","y","w","size"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.15,"maximum":1},"size":{"type":"number","minimum":0.02,"maximum":0.07}},"required":["x","y","w","size"]}},"required":["4x5","9x16","1x1"]}},"required":["font","weight","style","text","outline","shadow","align","rotate","box","place"]},"logo":{"type":"object","properties":{"on":{"type":"boolean"},"place":{"type":"object","properties":{"4x5":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.04,"maximum":0.6},"h":{"type":"number","minimum":0.02,"maximum":0.6}},"required":["x","y","w","h"]},"9x16":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.04,"maximum":0.6},"h":{"type":"number","minimum":0.02,"maximum":0.6}},"required":["x","y","w","h"]},"1x1":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"w":{"type":"number","minimum":0.04,"maximum":0.6},"h":{"type":"number","minimum":0.02,"maximum":0.6}},"required":["x","y","w","h"]}},"required":["4x5","9x16","1x1"]}},"required":["on","place"]}},"required":["background","quote","speaker","logo"]},"listenUrl":{"type":["string","null"],"maxLength":500},"linkedin":{"type":"object","properties":{"mentions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"id":{"type":"string","pattern":"^\\d{1,20}$"}},"required":["name","id"],"additionalProperties":false},"maxItems":5},"firstComment":{"type":"boolean"},"followUp":{"type":"boolean"}},"required":["mentions","firstComment","followUp"],"additionalProperties":false},"youtube":{"type":"object","properties":{"privacy":{"type":"string","enum":["public","unlisted","private"]},"madeForKids":{"type":"boolean"},"synthetic":{"type":"boolean"}},"required":["privacy","madeForKids","synthetic"],"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"200":{"description":"The brand kit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandKit"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/brand-kits/{id}/logo":{"put":{"summary":"Store the logo (PNG or SVG, at most 512 KB); an empty body removes it","tags":["Brand kits"],"security":[{"token":["brand:write"]}],"description":"Scope `brand:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":false,"content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/svg+xml":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"The brand kit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandKit"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"summary":"The logo's file","tags":["Brand kits"],"security":[{"token":["brand:read"]}],"description":"Scope `brand:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"PNG or SVG","content":{"image/png":{"schema":{"type":"string","format":"binary"}},"image/svg+xml":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/brand-kits/{id}/font":{"put":{"summary":"Store the kit's own font (TTF or OTF, at most 2 MB) as its heading font; an empty body removes it","tags":["Brand kits"],"security":[{"token":["brand:write"]}],"description":"Scope `brand:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":false,"content":{"font/ttf":{"schema":{"type":"string","format":"binary"}},"font/otf":{"schema":{"type":"string","format":"binary"}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"The brand kit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandKit"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"summary":"The own font's file","tags":["Brand kits"],"security":[{"token":["brand:read"]}],"description":"Scope `brand:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"TTF or OTF","content":{"font/ttf":{"schema":{"type":"string","format":"binary"}},"font/otf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/brand-kits/{id}/card-image":{"put":{"summary":"Store the card template's picture (JPEG, at most 2 MB); an empty body removes it","tags":["Brand kits"],"security":[{"token":["brand:write"]}],"description":"Scope `brand:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":false,"content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"The brand kit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandKit"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"summary":"The card template picture's file","tags":["Brand kits"],"security":[{"token":["brand:read"]}],"description":"Scope `brand:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"JPEG","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/brand-kits/{id}/restyle":{"post":{"summary":"Draw the kit's clips and quote cards again in its current look (workspace admins)","tags":["Brand kits"],"security":[{"token":["brand:write"]}],"description":"Scope `brand:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"apply":{"type":"boolean","description":"false: only what would be drawn again; true: do it"}},"required":["apply"],"additionalProperties":false}}}},"responses":{"200":{"description":"What is (or would be) drawn again","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Restyle"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/whitelabel":{"patch":{"summary":"The workspace's white label (workspace admins)","tags":["Workspaces"],"security":[{"token":["settings:write"]}],"description":"Scope `settings:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"domain":{"type":"string","maxLength":253},"emailSender":{"type":"string","maxLength":254},"themeBrandKitId":{"type":["string","null"],"pattern":"^[\\w-]{1,64}$"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The white label","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Whitelabel"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/stats":{"get":{"summary":"The overview's numbers","tags":["Workspaces"],"security":[{"token":["workspaces:read"]}],"description":"Scope `workspaces:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Numbers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/members":{"get":{"summary":"The workspace's team, with open invitations","tags":["Team"],"security":[{"token":["team:read"]}],"description":"Scope `team:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Members","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Member"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/seats":{"get":{"summary":"People of the organisation against the plan's limit","tags":["Team"],"security":[{"token":["team:read"]}],"description":"Scope `team:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Seats","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Seats"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/members/{id}":{"patch":{"summary":"Change a member's role (workspace admins)","tags":["Team"],"security":[{"token":["team:write"]}],"description":"Scope `team:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string","enum":["admin","cvd","editor","social"]}},"required":["role"],"additionalProperties":false}}}},"responses":{"200":{"description":"The member","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Member"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"summary":"Remove a member or withdraw an invitation (workspace admins)","tags":["Team"],"security":[{"token":["team:write"]}],"description":"Scope `team:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/invitations":{"post":{"summary":"Invite a person by email (workspace admins)","description":"No email goes out: the person signs in with that address and accepts in the app.\n\nScope `team:write`.","tags":["Team"],"security":[{"token":["team:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email"},"name":{"type":"string","minLength":2,"maxLength":80},"role":{"type":"string","enum":["admin","cvd","editor","social"]}},"required":["email","role"],"additionalProperties":false}}}},"responses":{"201":{"description":"The invitation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Member"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/integrations":{"get":{"summary":"Integrations and their connections","tags":["Integrations"],"security":[{"token":["integrations:read"]}],"description":"Scope `integrations:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Integrations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Integration"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/integrations/{id}":{"delete":{"summary":"Disconnect an integration (workspace admins)","description":"Connecting needs the provider's consent in the app.\n\nScope `integrations:write`.","tags":["Integrations"],"security":[{"token":["integrations:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","enum":["googleDrive","oneDrive","box","dropbox","youtube","instagram","facebook","tiktok","linkedin","x","wordpress","hootsuite","telegram","gemini","claude","chatgpt","jev","api","webhooks","watchFolder","mam","automations"]},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/editorial-rules":{"get":{"summary":"Editorial rules: house terms, blocked words, style guide","tags":["Settings"],"security":[{"token":["settings:read"]}],"description":"Scope `settings:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"The rules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialSettings"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"put":{"summary":"Replace the editorial rules (workspace admins, Business and up)","tags":["Settings"],"security":[{"token":["settings:write"]}],"description":"Scope `settings:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"terms":{"type":"array","items":{"type":"object","properties":{"avoid":{"type":"string","maxLength":80},"use":{"type":"string","maxLength":80}},"required":["avoid","use"],"additionalProperties":false},"maxItems":200},"blocked":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":300},"styleGuide":{"type":"string","maxLength":4000}},"required":["terms","blocked","styleGuide"],"additionalProperties":false}}}},"responses":{"200":{"description":"The rules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialSettings"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/security":{"get":{"summary":"Security settings and the default embargo","tags":["Settings"],"security":[{"token":["settings:read"]}],"description":"Scope `settings:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Security"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/webhooks":{"get":{"summary":"The workspace's webhooks","tags":["Webhooks"],"security":[{"token":["webhooks:read"]}],"description":"Scope `webhooks:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Webhooks","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"post":{"summary":"Subscribe an address to events (workspace admins)","tags":["Webhooks"],"security":[{"token":["webhooks:write"]}],"description":"Scope `webhooks:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2000,"description":"https, a public address"},"events":{"type":"array","items":{"type":"string","enum":["brand_kit.applied","clip.approved","clip.deleted","clip.delivered","clip.delivery_failed","clip.forwarded","clip.pushed","clip.rejected","clip.submitted","clip.video_failed","clip.video_ready","episode.analysed","episode.created","episode.deleted","episode.embargo_changed","episode.embargo_ended","episode.failed","episode.submitted","episode.updated","integration.connected","integration.disconnected","member.invitation_declined","member.invitation_withdrawn","member.invited","member.joined","member.removed","member.updated","post.failed","post.published","post.removal_refused","post.removal_requested","post.removed","post.rescheduled","post.scheduled","post.unscheduled","post.updated","quote_card.failed","quote_card.ready","workspace.updated"]},"minItems":1,"maxItems":60},"description":{"type":"string","maxLength":200,"default":""}},"required":["url","events"],"additionalProperties":false}}}},"responses":{"201":{"description":"The webhook and its secret, shown once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookWithSecret"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/webhooks/{id}":{"patch":{"summary":"Change, pause or resume a webhook","tags":["Webhooks"],"security":[{"token":["webhooks:write"]}],"description":"Scope `webhooks:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2000,"description":"https, a public address"},"events":{"type":"array","items":{"type":"string","enum":["brand_kit.applied","clip.approved","clip.deleted","clip.delivered","clip.delivery_failed","clip.forwarded","clip.pushed","clip.rejected","clip.submitted","clip.video_failed","clip.video_ready","episode.analysed","episode.created","episode.deleted","episode.embargo_changed","episode.embargo_ended","episode.failed","episode.submitted","episode.updated","integration.connected","integration.disconnected","member.invitation_declined","member.invitation_withdrawn","member.invited","member.joined","member.removed","member.updated","post.failed","post.published","post.removal_refused","post.removal_requested","post.removed","post.rescheduled","post.scheduled","post.unscheduled","post.updated","quote_card.failed","quote_card.ready","workspace.updated"]},"minItems":1,"maxItems":60},"description":{"type":"string","maxLength":200},"paused":{"type":"boolean","description":"false resumes and forgets the failures"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The webhook","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"summary":"Delete a webhook","tags":["Webhooks"],"security":[{"token":["webhooks:write"]}],"description":"Scope `webhooks:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/webhooks/{id}/secret":{"post":{"summary":"A new secret; the old one signs too for a day","tags":["Webhooks"],"security":[{"token":["webhooks:write"]}],"description":"Scope `webhooks:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The new secret, shown once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSecret"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/webhooks/{id}/test":{"post":{"summary":"Send a test event (webhook.test), also while paused","tags":["Webhooks"],"security":[{"token":["webhooks:write"]}],"description":"Scope `webhooks:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"202":{"description":"Queued: the worker sends it within seconds"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/webhooks/{id}/deliveries":{"get":{"summary":"A webhook's latest deliveries (30 days), newest first","tags":["Webhooks"],"security":[{"token":["webhooks:read"]}],"description":"Scope `webhooks:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Deliveries","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDelivery"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/connectors":{"get":{"summary":"The workspace's connectors (MAM/DAM)","tags":["Connectors"],"security":[{"token":["integrations:read"]}],"description":"Scope `integrations:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Connectors","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Connector"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/connectors/{id}":{"patch":{"summary":"Where released clips go (workspace admins)","description":"Each clip goes into <folder>/<episode id>/<clip id>/: video.mp4, subtitles.vtt, thumbnails or card pictures, and clip.json last (docs/connectors.md).\n\nScope `integrations:write`.","tags":["Connectors"],"security":[{"token":["integrations:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","enum":["mam"]},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":["string","null"],"pattern":"^[A-Za-z0-9_-]{1,200}$","description":"A folder id of the storage (GET …/storage/mam/files); null: clips no longer go there"},"auto":{"type":"boolean","description":"Released clips go there by themselves"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The connector","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Connector"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/deliveries":{"get":{"summary":"The latest deliveries, newest first","tags":["Connectors"],"security":[{"token":["integrations:read"]}],"description":"Scope `integrations:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Only this clip's"},"required":false,"description":"Only this clip's","name":"clipId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Deliveries","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ConnectorDelivery"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/clips/{id}/deliveries":{"post":{"summary":"Deliver a released clip (again) to the connectors","description":"Queues the clip for every connector with a delivery folder; the worker sends it within seconds (webhook clip.delivered, or clip.delivery_failed).\n\nScope `clips:write`.","tags":["Connectors"],"security":[{"token":["clips:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"202":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Delivered"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/library":{"get":{"summary":"Released clips and quote cards, newest release first","description":"Approved, planned or published. A clip whose episode is still under embargo is listed with embargoUntil; its files stay in ShowBits until then.\n\nScope `library:read`.","tags":["Library"],"security":[{"token":["library:read"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":200},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["clip","quote"],"description":"clip: highlights and memes; quote: quote cards"},"required":false,"description":"clip: highlights and memes; quote: quote cards","name":"kind","in":"query"},{"schema":{"type":"string","maxLength":200,"description":"Words in the title"},"required":false,"description":"Words in the title","name":"q","in":"query"}],"responses":{"200":{"description":"A page of released clips","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryPage"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/library/{id}":{"get":{"summary":"A released clip or quote card","tags":["Library"],"security":[{"token":["library:read"]}],"description":"Scope `library:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The clip","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LibraryItem"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/library/{id}/file":{"get":{"summary":"One of a released clip's files","description":"Redirects to a download link valid for an hour; logged as an export. 409 notReleased or embargo, 404 noFile (not there yet, or a variant the clip has not).\n\nScope `library:read`.","tags":["Library"],"security":[{"token":["library:read"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","enum":["video","16x9","9x16","4x5","1x1","motion-9x16","motion-4x5"],"description":"Clips: video, 16x9, 9x16 (thumbnails); quote cards: 4x5, 9x16, 1x1, and animated motion-9x16, motion-4x5 (MP4 with the speaker's voice, once rendered). Default: the video, a quote card's 4x5"},"required":false,"description":"Clips: video, 16x9, 9x16 (thumbnails); quote cards: 4x5, 9x16, 1x1, and animated motion-9x16, motion-4x5 (MP4 with the speaker's voice, once rendered). Default: the video, a quote card's 4x5","name":"variant","in":"query"}],"responses":{"302":{"description":"Redirects to a short-lived link to the file (one hour)","headers":{"location":{"schema":{"type":"string"},"required":true}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/wordpress/sites":{"get":{"summary":"Connected WordPress sites","tags":["WordPress"],"security":[{"token":["integrations:read"]}],"description":"Scope `integrations:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"}],"responses":{"200":{"description":"Sites, oldest first","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WordPressSite"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/wordpress/sites/{id}":{"delete":{"summary":"End a site's connection (its key too)","tags":["WordPress"],"security":[{"token":["integrations:write"]}],"description":"Scope `integrations:write`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Done"},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/wordpress/sites/{id}/pushes":{"post":{"summary":"Send released clips into a site's media library","description":"All or nothing: every clip released, its embargo over, its file there; the site fetches them itself. Workspace admins and owners.\n\nScope `posts:publish`.","tags":["WordPress"],"security":[{"token":["posts:publish"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clipIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"minItems":1,"maxItems":50,"description":"Released clips and quote cards, at most 50"}},"required":["clipIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Queued"}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/workspaces/{ws}/wordpress/pushes":{"get":{"summary":"Pushes of the last 30 days, newest first","tags":["WordPress"],"security":[{"token":["integrations:read"]}],"description":"Scope `integrations:read`.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$","description":"The workspace's address (slug)","example":"talk-am-abend"},"required":true,"description":"The workspace's address (slug)","name":"ws","in":"path"},{"schema":{"type":"string","maxLength":64},"required":false,"name":"siteId","in":"query"},{"schema":{"type":"string","maxLength":64},"required":false,"name":"clipId","in":"query"}],"responses":{"200":{"description":"Pushes","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WordPressPush"}}},"required":["data"]}}}},"401":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"webhooks":{}}