{"openapi":"3.1.0","info":{"title":"Proverbial Soup API","version":"1.0.0","description":"Beneficial · Timeless · Wholesome. Public read API for the Proverbial Soup library and daily proverb. Errors use RFC 9457 problem+json. Public GETs need no key (60 req/min/IP). Admin routes need `Authorization: Bearer <admin key>`.\n\n**Licensing:** every item carries a `rights` object. Scripture is LSB; clients must display `notice` (web) or `short_notice` with a link to `notice_url` (social).","license":{"name":"Content: quotation with attribution; LSB text per Lockman permission","url":"https://provsoup-api.morning-unit-956c.workers.dev/credits"}},"servers":[{"url":"/"}],"tags":[{"name":"proverbs","description":"The published library"},{"name":"daily","description":"Proverb of the day"},{"name":"search","description":"Search"},{"name":"images","description":"Images and renders"},{"name":"meta","description":"Health"},{"name":"admin","description":"Admin (review, add, queue, import)"}],"components":{"securitySchemes":{"adminKey":{"type":"http","scheme":"bearer","description":"Admin key (Worker secret ADMIN_KEY)."}},"schemas":{"Problem":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"request_id":{"type":"string"},"errors":{"type":"array","items":{}}},"required":["type","title","status","code"]},"ProverbList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Proverb"}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"]},"Proverb":{"type":"object","properties":{"id":{"type":"string","example":"pv_7kq2mxabcd"},"slug":{"type":"string"},"text":{"type":["string","null"],"description":"Verbatim text. Null for Scripture when the LSB cap is reached."},"attribution":{"type":["string","null"]},"citation":{"type":["string","null"]},"citation_url":{"type":["string","null"]},"category":{"type":"string","enum":["proverb","scripture","preacher","quote"]},"scripture_ref":{"type":["string","null"]},"translation":{"type":["string","null"]},"verification":{"type":"string"},"flags":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"rights":{"$ref":"#/components/schemas/Rights"},"photo":{"$ref":"#/components/schemas/Photo"},"images":{"type":"array","items":{"$ref":"#/components/schemas/Image"}},"links":{"type":"object","properties":{"self":{"type":"string"},"permalink":{"type":"string"},"images":{"type":"string"}},"required":["self","permalink","images"]}},"required":["id","slug","text","attribution","citation","citation_url","category","scripture_ref","translation","verification","flags","tags","created_at","updated_at","rights","photo","images","links"]},"Rights":{"type":"object","properties":{"license":{"type":"string"},"notice":{"type":["string","null"]},"short_notice":{"type":["string","null"]},"notice_url":{"type":["string","null"]},"reuse":{"type":"string"},"attribution_required":{"type":"boolean"}},"required":["license","notice","short_notice","notice_url","reuse","attribution_required"]},"Photo":{"type":["object","null"],"properties":{"provider":{"type":"string","example":"openverse"},"upstream_source":{"type":["string","null"],"example":"stocksnap"},"title":{"type":["string","null"]},"creator":{"type":["string","null"]},"creator_url":{"type":["string","null"]},"source_url":{"type":"string"},"license":{"type":"string","example":"cc0"},"license_version":{"type":["string","null"]},"license_url":{"type":["string","null"]},"attribution":{"type":["string","null"],"example":"Photo by Aaron Burden (CC0) via StockSnap / Openverse"}},"required":["provider","upstream_source","title","creator","creator_url","source_url","license","license_version","license_url","attribution"],"description":"Background photo used in the artwork, with credit and licence."},"Image":{"type":"object","properties":{"variant":{"type":"string","enum":["4x5","1x1","og"]},"format":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"bytes":{"type":["integer","null"]},"url":{"type":"string","format":"uri"}},"required":["variant","format","width","height","bytes","url"]},"Daily":{"type":"object","properties":{"date":{"type":"string"},"bucket":{"type":"string"},"proverb":{"$ref":"#/components/schemas/Proverb"}},"required":["date","bucket","proverb"]},"Render":{"type":"object","properties":{"hash":{"type":"string"},"status":{"type":"string","enum":["queued","done","failed"]},"url":{"type":["string","null"]},"request":{},"created_at":{"type":"string"}},"required":["hash","status","url","created_at"]},"RenderRequest":{"type":"object","properties":{"proverb_id":{"type":"string","pattern":"^pv_[a-z0-9]{10}$"},"aspect":{"type":"string","enum":["4x5","1x1","og"],"default":"4x5"},"theme":{"type":"string","enum":["teal","coral","cream","night"]},"width":{"type":"integer","minimum":320,"maximum":2160},"format":{"type":"string","enum":["jpg","png"],"default":"jpg"}},"required":["proverb_id"]},"Candidate":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["string","null"]},"attribution":{"type":["string","null"]},"citation":{"type":["string","null"]},"category":{"type":"string"},"scripture_ref":{"type":["string","null"]},"status":{"type":"string"},"dup_of":{"type":["string","null"]},"source_id":{"type":"string"},"created_at":{"type":"string"},"flags":{"type":"array","items":{"type":"string"}}},"required":["id","text","attribution","citation","category","scripture_ref","status","dup_of","source_id","created_at","flags"]},"AddResult":{"type":"object","properties":{"outcome":{"type":"string","enum":["approved","queued_for_review","needs_text"]},"proverb_id":{"type":["string","null"]},"candidate_id":{"type":["string","null"]},"flags":{"type":"array","items":{"type":"string"}}},"required":["outcome","proverb_id","candidate_id","flags"]},"AddRequest":{"type":"object","properties":{"text":{"type":"string","maxLength":1000,"description":"Verbatim text. For Scripture, the verse text pasted from the LSB."},"attribution":{"type":["string","null"],"maxLength":200},"citation":{"type":["string","null"],"maxLength":500},"scripture_ref":{"type":"string","maxLength":60,"example":"Proverbs 3:5–6"},"url":{"type":"string","format":"uri","description":"Where it was found (e.g. an X post URL)."},"manual":{"type":"boolean","default":true,"description":"Manual adds are pre-approved (still deduped). false = goes to the review queue."}}},"Decision":{"type":"object","properties":{"action":{"type":"string","enum":["approve","reject","skip"]},"reason":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":1000,"description":"Required when approving Scripture: the verse text pasted verbatim from the LSB."}},"required":["action"]},"QueueItem":{"type":"object","properties":{"id":{"type":"string"},"proverb_id":{"type":"string"},"pinned_date":{"type":["string","null"]},"status":{"type":"string"},"created_at":{"type":"string"}},"required":["id","proverb_id","pinned_date","status","created_at"]},"ImportRequest":{"type":"object","properties":{"source":{"type":"object","properties":{"id":{"type":"string","pattern":"^src_[a-z0-9_]+$"},"kind":{"type":"string"},"name":{"type":"string"},"url":{"type":["string","null"]},"license":{"type":["string","null"]},"priority":{"type":"string","enum":["primary","metadata"],"default":"primary"}},"required":["id","kind","name"]},"items":{"type":"array","items":{"type":"object","properties":{"source_ref":{"type":"string","minLength":1},"text":{"type":"string","minLength":1},"attribution":{"type":["string","null"]},"citation":{"type":["string","null"]},"label":{"type":["string","null"]},"created_at":{"type":["string","null"]},"legacy_image_url":{"type":["string","null"]}},"required":["source_ref","text"]},"minItems":1,"maxItems":5}},"required":["source","items"]},"ArtUpdate":{"type":"object","properties":{"visual_keywords":{"type":"array","items":{"type":"string","maxLength":60},"minItems":1,"maxItems":6},"photo":{"type":"object","properties":{"id":{"type":"string","maxLength":120},"provider":{"type":"string","maxLength":30},"provider_id":{"type":"string","maxLength":100},"upstream_source":{"type":["string","null"],"maxLength":50},"title":{"type":["string","null"],"maxLength":300},"creator":{"type":["string","null"],"maxLength":200},"creator_url":{"type":["string","null"],"maxLength":500},"source_url":{"type":"string","maxLength":500,"format":"uri"},"image_url":{"type":"string","maxLength":1000,"format":"uri"},"license":{"type":"string","maxLength":30},"license_version":{"type":["string","null"],"maxLength":20},"license_url":{"type":["string","null"],"maxLength":500},"attribution":{"type":["string","null"],"maxLength":400},"width":{"type":["integer","null"]},"height":{"type":["integer","null"]},"cached":{"type":"boolean"}},"required":["id","provider","provider_id","source_url","image_url","license"]},"art":{"type":"object","additionalProperties":{}}}}},"parameters":{}},"paths":{"/v1/health":{"get":{"tags":["meta"],"summary":"Health check","operationId":"getHealth","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"proverbs":{"type":"integer"},"time":{"type":"string"}},"required":["ok","proverbs","time"]}}}},"429":{"description":"Rate limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/proverbs":{"get":{"tags":["proverbs"],"summary":"List published proverbs (newest first, cursor-paginated)","operationId":"getProverbs","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["proverb","scripture","preacher","quote"]},"required":false,"name":"category","in":"query"},{"schema":{"type":"string"},"required":false,"name":"author","in":"query"}],"responses":{"200":{"description":"A page of proverbs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProverbList"}}}},"400":{"description":"Invalid parameters","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/proverbs/{id}":{"get":{"tags":["proverbs"],"summary":"Get one proverb","operationId":"getProverbsId","parameters":[{"schema":{"type":"string","pattern":"^pv_[a-z0-9]{10}$","example":"pv_7kq2mxabcd"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"The proverb","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proverb"}}}},"404":{"description":"Not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/proverbs/{id}/images":{"get":{"tags":["images"],"summary":"Image variants for a proverb","operationId":"getProverbsIdImages","parameters":[{"schema":{"type":"string","pattern":"^pv_[a-z0-9]{10}$","example":"pv_7kq2mxabcd"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Variants","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Image"}}},"required":["data"]}}}},"404":{"description":"Not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/daily":{"get":{"tags":["daily"],"summary":"Today's proverb (switches at 06:30 JST)","operationId":"getDaily","responses":{"200":{"description":"Today's proverb","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Daily"}}}},"404":{"description":"Library empty","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/daily/{date}":{"get":{"tags":["daily"],"summary":"Proverb for a given JST date (past or today)","operationId":"getDailyDate","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-11-16"},"required":true,"name":"date","in":"path"}],"responses":{"200":{"description":"Proverb of that day","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Daily"}}}},"404":{"description":"Not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/random":{"get":{"tags":["proverbs"],"summary":"A random proverb (repeatable with seed)","operationId":"getRandom","parameters":[{"schema":{"type":"string","enum":["proverb","scripture","preacher","quote"]},"required":false,"name":"category","in":"query"},{"schema":{"type":"string","maxLength":64},"required":false,"name":"seed","in":"query"}],"responses":{"200":{"description":"A proverb","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proverb"}}}},"404":{"description":"None","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/search":{"get":{"tags":["search"],"summary":"Keyword search (FTS5, BM25 ranking)","operationId":"getSearch","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"required":true,"name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Matches","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Proverb"}},"query":{"type":"string"}},"required":["data","query"]}}}},"400":{"description":"Invalid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/renders":{"post":{"tags":["images"],"summary":"Request a render (asynchronous on the free plan)","description":"Returns 202 and a job; the build-time renderer processes queued jobs and the result URL appears on GET /v1/renders/{hash}. Same input = same hash.","operationId":"postRenders","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenderRequest"}}}},"responses":{"200":{"description":"Already rendered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Render"}}}},"202":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Render"}}}},"404":{"description":"Unknown proverb","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/renders/{hash}":{"get":{"tags":["images"],"summary":"Render job status","operationId":"getRendersHash","parameters":[{"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"},"required":true,"name":"hash","in":"path"}],"responses":{"200":{"description":"Job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Render"}}}},"404":{"description":"Unknown","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/candidates":{"get":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"List candidates awaiting review","operationId":"getAdminCandidates","parameters":[{"schema":{"type":"string","enum":["new","approved","rejected","duplicate"],"default":"new"},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Candidates and Scripture awaiting LSB text","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Candidate"}},"needs_text":{"type":"array","items":{"$ref":"#/components/schemas/Proverb"}}},"required":["data","needs_text"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"post":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Add a proverb (manual adds are pre-approved, always deduped)","operationId":"postAdminCandidates","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddRequest"}}}},"responses":{"201":{"description":"Added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddResult"}}}},"400":{"description":"Invalid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Duplicate or near-duplicate","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/candidates/{id}/decision":{"post":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Approve, reject or skip a candidate (idempotent with Idempotency-Key)","operationId":"postAdminCandidatesIdDecision","parameters":[{"schema":{"type":"string","pattern":"^cd_[a-z0-9]{12}$"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"idempotency-key","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Decision"}}}},"responses":{"200":{"description":"Recorded","content":{"application/json":{"schema":{"type":"object","properties":{"candidate_id":{"type":"string"},"status":{"type":"string"},"proverb_id":{"type":["string","null"]},"replayed":{"type":"boolean"}},"required":["candidate_id","status","proverb_id","replayed"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Unknown","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Conflict","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Scripture needs text","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/proverbs/{id}/scripture-text":{"post":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Supply the verbatim LSB text for a Scripture item awaiting text","operationId":"postAdminProverbsIdScriptureText","parameters":[{"schema":{"type":"string","pattern":"^pv_[a-z0-9]{10}$","example":"pv_7kq2mxabcd"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":3,"maxLength":1500}},"required":["text"]}}}},"responses":{"200":{"description":"Published","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proverb"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Unknown","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Not awaiting text","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/queue":{"get":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Publishing queue and recent dailies","operationId":"getAdminQueue","responses":{"200":{"description":"Queue","content":{"application/json":{"schema":{"type":"object","properties":{"pending":{"type":"array","items":{"$ref":"#/components/schemas/QueueItem"}},"recent":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"proverb_id":{"type":"string"},"bucket":{"type":"string"}},"required":["date","proverb_id","bucket"]}}},"required":["pending","recent"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"post":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Queue a proverb (optionally pinned to a JST date)","operationId":"postAdminQueue","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"proverb_id":{"type":"string","pattern":"^pv_[a-z0-9]{10}$"},"pinned_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["proverb_id"]}}}},"responses":{"201":{"description":"Queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueItem"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Unknown","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Date taken","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/usage/scripture":{"get":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"LSB verse counter against the 1,000-verse cap","operationId":"getAdminUsageScripture","responses":{"200":{"description":"Usage","content":{"application/json":{"schema":{"type":"object","properties":{"translation":{"type":"string"},"cap":{"type":"number"},"verses_stored":{"type":"number"},"verses_published":{"type":"number"},"share_of_cap":{"type":"number"},"warn":{"type":"boolean"},"blocked":{"type":"boolean"},"notice":{"type":"string"}},"required":["translation","cap","verses_stored","verses_published","share_of_cap","warn","blocked","notice"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/import":{"post":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Idempotent batch import (max 5 items per call on the free plan)","operationId":"postAdminImport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportRequest"}}}},"responses":{"200":{"description":"Per-item outcomes","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["results"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/images":{"post":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Register rendered image variants (used by the renderer)","operationId":"postAdminImages","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"proverb_id":{"type":"string"},"variant":{"type":"string","enum":["4x5","1x1","og"]},"format":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"bytes":{"type":"integer"},"path":{"type":"string"},"theme":{"type":"string"}},"required":["proverb_id","variant","format","width","height","bytes","path","theme"]},"minItems":1,"maxItems":40}},"required":["images"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"registered":{"type":"number"}},"required":["registered"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/renders":{"get":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Queued render jobs (for the renderer)","operationId":"getAdminRenders","responses":{"200":{"description":"Jobs","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{}}},"required":["data"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/renders/{hash}":{"post":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Mark a render job done or failed","operationId":"postAdminRendersHash","parameters":[{"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"},"required":true,"name":"hash","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["done","failed"]},"path":{"type":"string"}},"required":["status"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/proverbs":{"get":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"All library items incl. unpublished (for the renderer and review)","operationId":"getAdminProverbs","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Page","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Proverb"},{"type":"object","properties":{"status":{"type":"string","enum":["approved","needs_text","hidden"]},"visual_keywords":{"type":["array","null"],"items":{"type":"string"}},"art":{"type":["object","null"],"additionalProperties":{}}},"required":["status","visual_keywords","art"]}]}},"next_cursor":{"type":["string","null"]}},"required":["data","next_cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/admin/proverbs/{id}/art":{"put":{"tags":["admin"],"security":[{"adminKey":[]}],"summary":"Store visual keywords, the chosen photo (with credit/licence) and the layout for a proverb","operationId":"putAdminProverbsIdArt","parameters":[{"schema":{"type":"string","pattern":"^pv_[a-z0-9]{10}$"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtUpdate"}}}},"responses":{"200":{"description":"Saved","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"photo_id":{"type":["string","null"]}},"required":["ok","photo_id"]}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Unknown","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"webhooks":{}}