{"openapi":"3.1.0","info":{"title":"Endata Publication API","version":"1.0.0"},"servers":[{"url":"https://app.endata.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/api/v1/publications":{"get":{"operationId":"publications_list","tags":["Discovery"],"summary":"List the publications this key can reach","responses":{"200":{"description":"items"},"401":{"description":"Invalid credentials"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/operations":{"get":{"operationId":"operations_list","tags":["Discovery"],"summary":"The operation catalog with each input schema","security":[],"responses":{"200":{"description":"operations"}}}},"/api/v1/publications/{publication}/articles":{"get":{"operationId":"published_articles_get","tags":["Published content"],"summary":"List published articles","description":"Required scope: published:read. The same read as the published_articles_list operation.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Items per response."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Matching items to skip."},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200},"description":"Full-text search in the publication's language."},{"name":"section","in":"query","required":false,"schema":{"type":"string"},"description":"Section slug."},{"name":"edition","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Pin the read to this edition; default is the current one."}],"responses":{"200":{"description":"publication, items and hasMore"},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/articles/{slug}":{"get":{"operationId":"published_article_get","tags":["Published content"],"summary":"Read a published article","description":"Required scope: published:read. The list envelope with one item.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"edition","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Pin the read to this edition; default is the current one."}],"responses":{"200":{"description":"publication, items and hasMore"},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/answers":{"get":{"operationId":"published_answers_get","tags":["Published content"],"summary":"List published answers to customer questions","description":"Required scope: published:read. The same read as the published_answers_list operation. Answers are not part of an edition.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Items per response."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Matching items to skip."},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200},"description":"Full-text search in the publication's language."},{"name":"section","in":"query","required":false,"schema":{"type":"string"},"description":"Section slug."}],"responses":{"200":{"description":"publication, items and hasMore"},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/answers/{slug}":{"get":{"operationId":"published_answer_get","tags":["Published content"],"summary":"Read a published answer","description":"Required scope: published:read. The list envelope with one item.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"publication, items and hasMore"},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/confirmations":{"post":{"operationId":"prepare_action","tags":["Discovery"],"summary":"Prepare a consequential operation for confirmation","description":"Returns a confirmation token bound to the exact operation, input and current state, valid for ten minutes. It does not grant a service key permission.","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["operation"],"properties":{"operation":{"type":"string"},"input":{"type":"object"}},"additionalProperties":false}}}},"responses":{"200":{"description":"confirmationToken and a summary of the action"},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/published_articles_list":{"post":{"operationId":"published_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":false,"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)$"}},"required":["limit","offset","q"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/published_article_read":{"post":{"operationId":"published_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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/published_answers_list":{"post":{"operationId":"published_answers_list","tags":["Published content"],"summary":"List published answers to customer questions","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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]+)*$"}},"required":["limit","offset","q"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/published_answer_read":{"post":{"operationId":"published_answer_read","tags":["Published content"],"summary":"Read a published answer","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","minLength":1}},"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":["Publication"],"summary":"Publication and taxonomy","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":["Publication"],"summary":"Publication overview","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/articles_list":{"post":{"operationId":"articles_list","tags":["Articles"],"summary":"List articles and drafts","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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},"status":{"default":"all","type":"string","enum":["all","draft","changes","ready","scheduled","published","removal","trash"]},"sort":{"default":"edited","type":"string","enum":["edited","oldest","title","due"]},"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)$"},"generated":{"type":"string","enum":["true","false"]}},"required":["limit","offset","q","status","sort"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":["Articles"],"summary":"Read an article or draft","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"articleId":{"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":["articleId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_history":{"post":{"operationId":"article_history","tags":["Articles"],"summary":"Read an article's revision history","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"articleId":{"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":["articleId","offset"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_create":{"post":{"operationId":"article_create","tags":["Articles"],"summary":"Create an article 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":false,"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}},"products":{"maxItems":6,"type":"array","items":{"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)$"}},"question":{"type":"string","minLength":1,"maxLength":200},"shortAnswer":{"type":"string","maxLength":600},"perspective":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000},"attribution":{"default":"","type":"string","maxLength":200}},"required":["text","attribution"],"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_update":{"post":{"operationId":"article_update","tags":["Articles"],"summary":"Save a new revision of an article","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":false,"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}},"products":{"maxItems":6,"type":"array","items":{"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)$"}},"question":{"type":"string","minLength":1,"maxLength":200},"shortAnswer":{"type":"string","maxLength":600},"perspective":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000},"attribution":{"default":"","type":"string","maxLength":200}},"required":["text","attribution"],"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)$"},"articleId":{"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","articleId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_preview":{"post":{"operationId":"article_preview","tags":["Articles"],"summary":"Preview an article draft as it would be published","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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}},"products":{"maxItems":6,"type":"array","items":{"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)$"}},"question":{"type":"string","minLength":1,"maxLength":200},"shortAnswer":{"type":"string","maxLength":600},"perspective":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000},"attribution":{"default":"","type":"string","maxLength":200}},"required":["text","attribution"],"additionalProperties":false}},"required":["title","images","imageCandidate","summary","body","authorId","sectionId","tags","sources"],"additionalProperties":false},"articleId":{"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_approve":{"post":{"operationId":"article_approve","tags":["Articles"],"summary":"Approve an exact revision of an article","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"articleId":{"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)$"},"urgency":{"type":"string","enum":["optimized","timely","urgent"]}},"required":["articleId","revisionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_urgency":{"post":{"operationId":"article_urgency","tags":["Articles"],"summary":"Change an article's urgency for pending automatic shares","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"articleId":{"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)$"},"urgency":{"type":"string","enum":["optimized","timely","urgent"]}},"required":["articleId","urgency"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_action":{"post":{"operationId":"article_action","tags":["Articles"],"summary":"Restore, trash, recover or schedule an article","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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","enum":["restore","trash","recover","schedule","reschedule","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)))$"},"articleId":{"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","articleId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_unpublish":{"post":{"operationId":"article_unpublish","tags":["Publishing"],"summary":"Stage an article 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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"articleId":{"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":["articleId","expectedRevision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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},"answerGuide":{"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$"},"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"timeZone":{"type":"string","maxLength":100},"maxDrafts":{"type":"integer","minimum":1,"maximum":50},"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/questions_list":{"post":{"operationId":"questions_list","tags":["Questions and answers"],"summary":"List the questions customers ask, with each one's answer and what to answer next","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"filter":{"default":"all","type":"string","enum":["suggested","accepted","researching","drafted","answered","dismissed","open","to-answer","needs-update","all"]},"offset":{"default":0,"type":"integer","minimum":0,"maximum":10000},"limit":{"default":50,"type":"integer","minimum":1,"maximum":100}},"required":["filter","offset","limit"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/questions_stats":{"post":{"operationId":"questions_stats","tags":["Questions and answers"],"summary":"How the body of answers grew: published, updated with new research, new questions","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"days":{"type":"integer","minimum":7,"maximum":365}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/search_ai_read":{"post":{"operationId":"search_ai_read","tags":["Publication"],"summary":"Search and AI: retrieval requests, AI referral visits, and search queries; retrieval is not a confirmed citation","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"days":{"type":"integer","minimum":7,"maximum":90}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/discovery_read":{"post":{"operationId":"discovery_read","tags":["Questions and answers"],"summary":"Discovery: share of customer questions answered, what to answer next, and growth","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"days":{"type":"integer","minimum":7,"maximum":365}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/question_read":{"post":{"operationId":"question_read","tags":["Questions and answers"],"summary":"Read a question with its answer, evidence and history","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/question_create":{"post":{"operationId":"question_create","tags":["Questions and answers"],"summary":"Add a customer question to answer","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{},"customers":{"default":"","type":"string","maxLength":120}},"required":["text","customers"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/question_update":{"post":{"operationId":"question_update","tags":["Questions and answers"],"summary":"Reword a question or change who asks it","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{},"customers":{"type":"string","maxLength":120},"questionId":{"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":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/questions_suggest":{"post":{"operationId":"questions_suggest","tags":["Questions and answers"],"summary":"Suggest new customer questions 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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"topicId":{"type":"string","minLength":1,"maxLength":64}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/question_accept":{"post":{"operationId":"question_accept","tags":["Questions and answers"],"summary":"Accept a suggested question, or restore a dismissed one","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/question_dismiss":{"post":{"operationId":"question_dismiss","tags":["Questions and answers"],"summary":"Dismiss a question; its draft answer goes to the trash with it","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/question_research":{"post":{"operationId":"question_research","tags":["Questions and answers"],"summary":"Research and draft (or refresh) the answer to a question 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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/question_perspective":{"post":{"operationId":"question_perspective","tags":["Questions and answers"],"summary":"Add the business's own perspective to a question's answer","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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)$"},"text":{"type":"string","minLength":1,"maxLength":4000},"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)$"}},"required":["questionId","text"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/answer_read":{"post":{"operationId":"answer_read","tags":["Questions and answers"],"summary":"Read a question's answer: its draft, and whether readers see it","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/answer_history":{"post":{"operationId":"answer_history","tags":["Questions and answers"],"summary":"Read an answer's revision history","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId","offset"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/answer_preview":{"post":{"operationId":"answer_preview","tags":["Questions and answers"],"summary":"Preview an answer as it would be published","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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)$"},"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}},"products":{"maxItems":6,"type":"array","items":{"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)$"}},"question":{"type":"string","minLength":1,"maxLength":200},"shortAnswer":{"type":"string","maxLength":600},"perspective":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000},"attribution":{"default":"","type":"string","maxLength":200}},"required":["text","attribution"],"additionalProperties":false}},"required":["title","images","imageCandidate","summary","body","authorId","sectionId","tags","sources"],"additionalProperties":false}},"required":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/answer_create":{"post":{"operationId":"answer_create","tags":["Questions and answers"],"summary":"Write a question's answer by hand, as its first 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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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)$"},"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}},"products":{"maxItems":6,"type":"array","items":{"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)$"}},"question":{"type":"string","minLength":1,"maxLength":200},"shortAnswer":{"type":"string","maxLength":600},"perspective":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000},"attribution":{"default":"","type":"string","maxLength":200}},"required":["text","attribution"],"additionalProperties":false}},"required":["title","images","imageCandidate","summary","body","authorId","sectionId","tags","sources"],"additionalProperties":false}},"required":["questionId","content"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/answer_update":{"post":{"operationId":"answer_update","tags":["Questions and answers"],"summary":"Save a new draft of an answer","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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)$"},"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}},"products":{"maxItems":6,"type":"array","items":{"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)$"}},"question":{"type":"string","minLength":1,"maxLength":200},"shortAnswer":{"type":"string","maxLength":600},"perspective":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000},"attribution":{"default":"","type":"string","maxLength":200}},"required":["text","attribution"],"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)$"}},"required":["questionId","content","expectedRevision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/answer_keep":{"post":{"operationId":"answer_keep","tags":["Questions and answers"],"summary":"Set aside a pending update and keep the published answer","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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/answer_publish":{"post":{"operationId":"answer_publish","tags":["Questions and answers"],"summary":"Publish an answer's draft to the website at once","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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId","revisionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/answer_unpublish":{"post":{"operationId":"answer_unpublish","tags":["Questions and answers"],"summary":"Take a published answer off the website; its draft is kept","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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"questionId":{"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":["questionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/published_authors_list":{"post":{"operationId":"published_authors_list","tags":["Published content"],"summary":"List the authors of published articles and answers","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/published_sections_list":{"post":{"operationId":"published_sections_list","tags":["Published content"],"summary":"List the sections of published articles and answers","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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},"distribution":{"type":"object","properties":{"publishOnApprove":{"type":"boolean"},"defaultUrgency":{"type":"string","enum":["optimized","timely","urgent"]},"postingSchedule":{"type":"object","properties":{"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"start":{"type":"integer","minimum":0,"maximum":23},"end":{"type":"integer","minimum":1,"maximum":24}},"required":["days","start","end"],"additionalProperties":false},"autoShareAccounts":{"maxItems":30,"type":"array","items":{"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)$"}},"captionStyle":{"type":"object","properties":{"mode":{"type":"string","enum":["teaser","summary"]},"tone":{"type":"string","enum":["plain","analytical","conversational"]},"hashtags":{"type":"boolean"},"emoji":{"type":"boolean"}},"required":["mode","tone","hashtags","emoji"],"additionalProperties":false},"linkCta":{"type":"string","maxLength":120},"includeLink":{"type":"boolean"},"channelDefaults":{"type":"object","propertyNames":{"type":"string","enum":["linkedin","bluesky","facebook","instagram","threads","x","linkedin_page","tiktok","youtube","pinterest"]},"additionalProperties":{"type":"object","properties":{"postingSchedule":{"type":"object","properties":{"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"start":{"type":"integer","minimum":0,"maximum":23},"end":{"type":"integer","minimum":1,"maximum":24}},"required":["days","start","end"],"additionalProperties":false},"maxPerWeek":{"type":"integer","minimum":1,"maximum":50},"captionStyle":{"type":"object","properties":{"mode":{"type":"string","enum":["teaser","summary"]},"tone":{"type":"string","enum":["plain","analytical","conversational"]},"hashtags":{"type":"boolean"},"emoji":{"type":"boolean"}},"additionalProperties":false},"linkCta":{"type":"string","maxLength":120},"includeLink":{"type":"boolean"},"format":{"type":"string","enum":["link","carousel","video"]}},"additionalProperties":false}}},"required":["publishOnApprove","defaultUrgency","postingSchedule","autoShareAccounts","captionStyle"],"additionalProperties":false}},"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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 an article's sharing status","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"articleId":{"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":["articleId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/article_share":{"post":{"operationId":"article_share","tags":["Publishing"],"summary":"Share an article 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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"articleId":{"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":4900},"when":{"type":"string","enum":["now","at","published","auto"]},"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","video"]},"options":{"type":"object","properties":{"privacyLevel":{"type":"string","enum":["PUBLIC_TO_EVERYONE","MUTUAL_FOLLOW_FRIENDS","FOLLOWER_OF_CREATOR","SELF_ONLY"]},"allowComment":{"type":"boolean"},"allowDuet":{"type":"boolean"},"allowStitch":{"type":"boolean"},"disclose":{"type":"boolean"},"brandOrganic":{"type":"boolean"},"brandedContent":{"type":"boolean"}},"additionalProperties":false}},"required":["articleId","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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"articleId":{"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":["articleId","shareId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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":["Publication"],"summary":"Read publication activity","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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":33,"type":"array","items":{"type":"string","enum":["article.draft_saved","article.approved","article.scheduled","article.schedule_canceled","article.trashed","article.recovered","article.removal_changed","research.queued","research.running","research.completed","research.failed","question.suggested","question.accepted","question.researched","question.answered","question.updated","question.unpublished","newsletter.campaign_created","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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/widgets_list":{"post":{"operationId":"widgets_list","tags":["Website widgets"],"summary":"List the publication's widgets and when their data last changed","description":"Required scope: editorial:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"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"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/widget_read":{"post":{"operationId":"widget_read","tags":["Website widgets"],"summary":"Read a widget's settings and data","description":"Required scope: published:read. ","parameters":[{"name":"publication","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":63}},"required":["key"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}},"/api/v1/publications/{publication}/operations/widget_data_put":{"post":{"operationId":"widget_data_put","tags":["Website widgets"],"summary":"Replace a widget's data, such as a ticker's prices","description":"Required scope: widgets: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":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["key","data"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"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}},{"name":"X-Confirmation-Token","in":"header","required":false,"description":"From the confirmations endpoint. Not needed by a key with an unattended grant for this scope.","schema":{"type":"string"}}],"requestBody":{"required":false,"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":3,"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},"questionSetup":{"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)$"},"questionIds":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["suggestionId","questionIds"],"additionalProperties":false},"timeZone":{"default":"America/Chicago","type":"string","maxLength":100},"language":{"default":"en","type":"string","enum":["en","es","pt-BR"]},"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","language"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation result; asynchronous operations return a job or batch ID."},"400":{"description":"Invalid input"},"401":{"description":"Invalid credentials"},"402":{"description":"The plan does not include this, or its allowance is used"},"403":{"description":"Insufficient scope, role or unattended grant"},"404":{"description":"Not found in this publication"},"409":{"description":"Stale revision or conflicting request"},"428":{"description":"Confirmation required"},"429":{"description":"Rate limit exceeded"}}}}}}