{"openapi":"3.1.0","info":{"title":"Endata Newsroom API","version":"1.0.0"},"servers":[{"url":"https://app.endata.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/api/v1/publications/{publication}/operations/articles_list":{"post":{"operationId":"articles_list","tags":["Published content"],"summary":"List published articles","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":10000},"q":{"default":"","type":"string","maxLength":200},"section":{"type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"edition":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"default":"all","type":"string","enum":["all","draft","changes","ready","scheduled","published","removal","trash"]},"trash":{"default":"false","type":"string","enum":["true","false"]}},"required":["limit","offset","q","status","trash"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_read":{"post":{"operationId":"article_read","tags":["Published content"],"summary":"Read a published article","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","minLength":1},"edition":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["slug"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/publication_read":{"post":{"operationId":"publication_read","tags":["Editorial"],"summary":"Publication and taxonomy","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/overview_read":{"post":{"operationId":"overview_read","tags":["Editorial"],"summary":"Newsroom overview","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/stories_list":{"post":{"operationId":"stories_list","tags":["Editorial"],"summary":"List stories and drafts","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"offset":{"default":0,"type":"integer","minimum":0,"maximum":10000},"q":{"default":"","type":"string","maxLength":200},"section":{"type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"edition":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"default":"all","type":"string","enum":["all","draft","changes","ready","scheduled","published","removal","trash"]},"trash":{"default":"false","type":"string","enum":["true","false"]}},"required":["limit","offset","q","status","trash"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_read":{"post":{"operationId":"story_read","tags":["Editorial"],"summary":"Read a story","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["postId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_history":{"post":{"operationId":"story_history","tags":["Editorial"],"summary":"Read revision history","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"offset":{"default":0,"type":"integer","minimum":0,"maximum":10000}},"required":["postId","offset"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_create":{"post":{"operationId":"story_create","tags":["Editorial"],"summary":"Create a draft","description":"Required scope: editorial:write. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":120,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"content":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":250},"images":{"default":[],"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"alt":{"default":"","type":"string","maxLength":500},"sourceUrl":{"type":"string","format":"uri"},"credit":{"default":"","type":"string","maxLength":500},"originalId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false}},"required":["id","alt","credit"],"additionalProperties":false}},"imageCandidate":{"default":null,"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri"},"sourceUrl":{"type":"string","format":"uri"}},"required":["url","sourceUrl"],"additionalProperties":false},{"type":"null"}]},"summary":{"type":"string","minLength":1,"maxLength":600},"body":{"type":"string","minLength":1,"maxLength":250000},"authorId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"tags":{"default":[],"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"sources":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":250},"url":{"type":"string","format":"uri"}},"required":["title","url"],"additionalProperties":false}}},"required":["title","images","imageCandidate","summary","body","authorId","sectionId","tags","sources"],"additionalProperties":false}},"required":["slug","content"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_update":{"post":{"operationId":"story_update","tags":["Editorial"],"summary":"Save a new revision","description":"Required scope: editorial:write. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"content":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":250},"images":{"default":[],"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"alt":{"default":"","type":"string","maxLength":500},"sourceUrl":{"type":"string","format":"uri"},"credit":{"default":"","type":"string","maxLength":500},"originalId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false}},"required":["id","alt","credit"],"additionalProperties":false}},"imageCandidate":{"default":null,"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri"},"sourceUrl":{"type":"string","format":"uri"}},"required":["url","sourceUrl"],"additionalProperties":false},{"type":"null"}]},"summary":{"type":"string","minLength":1,"maxLength":600},"body":{"type":"string","minLength":1,"maxLength":250000},"authorId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"tags":{"default":[],"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"sources":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":250},"url":{"type":"string","format":"uri"}},"required":["title","url"],"additionalProperties":false}}},"required":["title","images","imageCandidate","summary","body","authorId","sectionId","tags","sources"],"additionalProperties":false},"expectedRevision":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["content","expectedRevision","postId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_preview":{"post":{"operationId":"story_preview","tags":["Editorial"],"summary":"Preview a draft","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"content":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":250},"images":{"default":[],"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"alt":{"default":"","type":"string","maxLength":500},"sourceUrl":{"type":"string","format":"uri"},"credit":{"default":"","type":"string","maxLength":500},"originalId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false}},"required":["id","alt","credit"],"additionalProperties":false}},"imageCandidate":{"default":null,"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri"},"sourceUrl":{"type":"string","format":"uri"}},"required":["url","sourceUrl"],"additionalProperties":false},{"type":"null"}]},"summary":{"type":"string","minLength":1,"maxLength":600},"body":{"type":"string","minLength":1,"maxLength":250000},"authorId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"tags":{"default":[],"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"sources":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":250},"url":{"type":"string","format":"uri"}},"required":["title","url"],"additionalProperties":false}}},"required":["title","images","imageCandidate","summary","body","authorId","sectionId","tags","sources"],"additionalProperties":false},"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["content"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_approve":{"post":{"operationId":"story_approve","tags":["Editorial"],"summary":"Approve an exact revision","description":"Required scope: editorial:approve. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["postId","revisionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_action":{"post":{"operationId":"story_action","tags":["Editorial"],"summary":"Restore, trash, recover or schedule a story","description":"Required scope: editorial:write. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","enum":["restore","trash","recover","schedule","cancel-schedule"]},"expectedRevision":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"scheduledAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["action","expectedRevision","postId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_unpublish":{"post":{"operationId":"story_unpublish","tags":["Publishing"],"summary":"Stage a story for removal from the next edition","description":"Required scope: publishing:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedRevision":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["postId","expectedRevision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/publishing_read":{"post":{"operationId":"publishing_read","tags":["Publishing"],"summary":"Read publishing status and batches","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/publication_publish":{"post":{"operationId":"publication_publish","tags":["Publishing"],"summary":"Publish approved revisions and staged removals","description":"Required scope: publishing:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/publication_retry":{"post":{"operationId":"publication_retry","tags":["Publishing"],"summary":"Retry a frozen publication batch","description":"Required scope: publishing:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"batchId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["batchId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/research_read":{"post":{"operationId":"research_read","tags":["Research"],"summary":"Read research configuration and runs","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"offset":{"default":0,"type":"integer","minimum":0,"maximum":10000}},"required":["offset"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/research_run":{"post":{"operationId":"research_run","tags":["Research"],"summary":"Queue research within plan limits","description":"Required scope: editorial:write. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/research_configure":{"post":{"operationId":"research_configure","tags":["Research"],"summary":"Configure research automation","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"topics":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"guide":{"type":"string","maxLength":30000},"authorId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"paused":{"type":"boolean"},"localTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"timeZone":{"type":"string","maxLength":100},"maxDrafts":{"type":"integer","minimum":1,"maximum":20},"model":{"type":"string","minLength":1,"maxLength":100}},"required":["topics","guide","authorId","paused","localTime","timeZone","maxDrafts","model"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/research_source_save":{"post":{"operationId":"research_source_save","tags":["Research"],"summary":"Add or update a research source","description":"Required scope: editorial:write. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"url":{"type":"string","format":"uri"},"name":{"type":"string","minLength":1,"maxLength":200},"enabled":{"type":"boolean"}},"required":["url","name","enabled"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/research_retry":{"post":{"operationId":"research_retry","tags":["Research"],"summary":"Retry a research candidate","description":"Required scope: editorial:write. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"candidateId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["candidateId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/media_upload":{"post":{"operationId":"media_upload","tags":["Media"],"summary":"Upload an image","description":"Required scope: editorial:write. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"base64":{"type":"string","minLength":4,"maxLength":13333336,"pattern":"^[A-Za-z0-9+/]+={0,2}$"},"credit":{"default":"","type":"string","maxLength":500},"sourceUrl":{"type":"string","format":"uri"},"permissionConfirmed":{"type":"boolean","const":true}},"required":["base64","credit","permissionConfirmed"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/media_list":{"post":{"operationId":"media_list","tags":["Media"],"summary":"List publication images","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"offset":{"default":0,"type":"integer","minimum":0,"maximum":10000}},"required":["offset"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/authors_list":{"post":{"operationId":"authors_list","tags":["Published content"],"summary":"List published authors","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/sections_list":{"post":{"operationId":"sections_list","tags":["Published content"],"summary":"List published sections","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/media_import":{"post":{"operationId":"media_import","tags":["Media"],"summary":"Import an attributed source image","description":"Required scope: editorial:write. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","format":"uri"},"sourceUrl":{"type":"string","format":"uri"},"permissionConfirmed":{"type":"boolean","const":true},"credit":{"default":"","type":"string","maxLength":500}},"required":["url","sourceUrl","permissionConfirmed","credit"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/taxonomy_save":{"post":{"operationId":"taxonomy_save","tags":["Publication settings"],"summary":"Add or update authors and sections","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"authors":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":100},"bio":{"default":"","type":"string","maxLength":2000},"imageId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["name","bio"],"additionalProperties":false}},"sections":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":100},"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["name","slug"],"additionalProperties":false}}},"required":["authors","sections"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/media_crop":{"post":{"operationId":"media_crop","tags":["Media"],"summary":"Crop a publication image","description":"Required scope: editorial:write. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"imageId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"crop":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","exclusiveMinimum":0,"maximum":1},"height":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false}},"required":["imageId","crop"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/domains_list":{"post":{"operationId":"domains_list","tags":["Publication settings"],"summary":"List publication domains","description":"Required scope: administration:manage. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/domain_add":{"post":{"operationId":"domain_add","tags":["Publication settings"],"summary":"Request a custom domain","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"hostname":{"type":"string"}},"required":["hostname"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/domain_remove":{"post":{"operationId":"domain_remove","tags":["Publication settings"],"summary":"Disable or remove a domain","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"hostname":{"type":"string"}},"required":["hostname"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/publication_update":{"post":{"operationId":"publication_update","tags":["Publication settings"],"summary":"Update publication details","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"timeZone":{"type":"string","maxLength":100}},"required":["name","timeZone"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/connections_list":{"post":{"operationId":"connections_list","tags":["Publication settings"],"summary":"List social connections","description":"Required scope: administration:manage. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/connection_remove":{"post":{"operationId":"connection_remove","tags":["Publication settings"],"summary":"Disconnect a social account","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"connectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["connectionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/integrations_list":{"post":{"operationId":"integrations_list","tags":["Publication settings"],"summary":"List integrations and their connection status","description":"Required scope: administration:manage. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/integration_save":{"post":{"operationId":"integration_save","tags":["Publication settings"],"summary":"Connect or update an integration","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"provider":{"type":"string","maxLength":60},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","maxLength":2000}},"events":{"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}},"rotateLink":{"type":"boolean"}},"required":["provider"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/integration_test":{"post":{"operationId":"integration_test","tags":["Publication settings"],"summary":"Send a chat test message or check an email integration","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"provider":{"type":"string","maxLength":60}},"required":["provider"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/integration_remove":{"post":{"operationId":"integration_remove","tags":["Publication settings"],"summary":"Disconnect an integration","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"provider":{"type":"string","maxLength":60}},"required":["provider"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/share_read":{"post":{"operationId":"share_read","tags":["Publishing"],"summary":"Read story sharing status","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["postId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/story_share":{"post":{"operationId":"story_share","tags":["Publishing"],"summary":"Share a story now, at a time, or when it is published","description":"Required scope: publishing:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"connectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"commentary":{"type":"string","minLength":1,"maxLength":2900},"when":{"type":"string","enum":["now","at","published"]},"sendAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"includeImage":{"type":"boolean"},"format":{"type":"string","enum":["link","carousel"]}},"required":["postId","connectionId","commentary"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/share_cancel":{"post":{"operationId":"share_cancel","tags":["Publishing"],"summary":"Cancel a scheduled share","description":"Required scope: publishing:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"postId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"shareId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["postId","shareId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/activity_list":{"post":{"operationId":"activity_list","tags":["Editorial"],"summary":"Read publication activity","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"offset":{"default":0,"type":"integer","minimum":0,"maximum":10000}},"required":["offset"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/webhooks_list":{"post":{"operationId":"webhooks_list","tags":["Webhooks"],"summary":"Read webhooks and delivery history","description":"Required scope: administration:manage. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/webhook_create":{"post":{"operationId":"webhook_create","tags":["Webhooks"],"summary":"Create a webhook endpoint","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","maxLength":2000,"format":"uri"},"events":{"minItems":1,"maxItems":26,"type":"array","items":{"type":"string","enum":["story.draft_saved","story.approved","story.scheduled","story.schedule_canceled","story.trashed","story.recovered","story.removal_changed","research.queued","research.running","research.completed","research.failed","publication.queued","publication.running","publication.succeeded","publication.failed","edition.published","share.scheduled","share.queued","share.sending","share.sent","share.failed","share.uncertain","share.canceled","social.expiring","integration.failed","webhook.test"]}}},"required":["name","url","events"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/webhook_action":{"post":{"operationId":"webhook_action","tags":["Webhooks"],"summary":"Manage a webhook endpoint","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"endpointId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"action":{"type":"string","enum":["pause","resume","rotate","test","delete"]}},"required":["endpointId","action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/webhook_replay":{"post":{"operationId":"webhook_replay","tags":["Webhooks"],"summary":"Replay a webhook delivery","description":"Required scope: administration:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deliveryId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["deliveryId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/team_read":{"post":{"operationId":"team_read","tags":["Organization"],"summary":"Read organization members and invitations","description":"Required scope: organization:manage. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"offset":{"default":0,"type":"integer","minimum":0,"maximum":10000}},"required":["offset"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/team_invite":{"post":{"operationId":"team_invite","tags":["Organization"],"summary":"Invite an organization member","description":"Required scope: organization:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["owner","editor","reviewer"]}},"required":["email","role"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/invitation_revoke":{"post":{"operationId":"invitation_revoke","tags":["Organization"],"summary":"Revoke an invitation","description":"Required scope: organization:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"invitationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["invitationId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/member_update":{"post":{"operationId":"member_update","tags":["Organization"],"summary":"Change an organization member role","description":"Required scope: organization:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"subject":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["owner","editor","reviewer"]},{"type":"null"}]}},"required":["subject","role"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/publication_create":{"post":{"operationId":"publication_create","tags":["Organization"],"summary":"Create a publication within organization limits","description":"Required scope: organization:manage. Consequential action: owner unattended grant or personal confirmation required.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":100},"slug":{"type":"string","minLength":1,"maxLength":63,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"authorName":{"type":"string","minLength":2,"maxLength":100},"sectionName":{"type":"string","minLength":2,"maxLength":100},"topicSetup":{"type":"object","properties":{"suggestionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"selections":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"object","properties":{"topicId":{"type":"string","minLength":1,"maxLength":64},"sectionName":{"type":"string","minLength":2,"maxLength":100}},"required":["topicId","sectionName"],"additionalProperties":false}}},"required":["suggestionId","selections"],"additionalProperties":false},"timeZone":{"default":"America/Chicago","type":"string","maxLength":100},"sourceSetup":{"type":"object","properties":{"autoAddSources":{"default":false,"type":"boolean"},"industryId":{"default":null,"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"sourceIds":{"maxItems":200,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"customSources":{"default":[],"maxItems":200,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"url":{"type":"string","maxLength":2048,"format":"uri"}},"required":["name","url"],"additionalProperties":false}}},"required":["autoAddSources","industryId","customSources"],"additionalProperties":false}},"required":["name","slug","authorName","timeZone"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"403":{"description":"Insufficient scope, role or unattended grant"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}}}}