{"service":"requisition-desk-api","description":"Programmatic intake for the Requisition Desk — file procurement requisitions and manage your own API keys.","apiVersion":"v1","baseUrl":"https://api.reqdesk.com","authentication":{"scheme":"Bearer","header":"Authorization: Bearer <key>","note":"Mint keys via POST /v1/keys (needs the keys:manage scope); with no key yet, self-serve one from your email via POST /v1/auth/codes then POST /v1/auth/keys, or ask the desk."},"scopes":[{"name":"requisitions:write","description":"File and amend requisitions (includes read access)."},{"name":"requisitions:read","description":"List and read requisitions (read-only)."},{"name":"keys:manage","description":"Mint, list, and revoke your partner's API keys."}],"links":{"guide":"https://api.reqdesk.com/llms.txt","requisitionSchema":"https://api.reqdesk.com/v1/schema/requisition.json"},"endpoints":[{"method":"GET","path":"/","summary":"Discovery index — this document.","scope":null},{"method":"POST","path":"/v1/requisitions","summary":"File a requisition.","scope":"requisitions:write"},{"method":"GET","path":"/v1/requisitions","summary":"List your requisitions, newest first (filter by status, page with cursor).","scope":"requisitions:read"},{"method":"GET","path":"/v1/requisitions/{id}","summary":"Fetch a requisition by its RD-… reference.","scope":"requisitions:read"},{"method":"POST","path":"/v1/requisitions/{id}/enrichments","summary":"Correct or extend a filed requisition (append-only set/add/remove).","scope":"requisitions:write"},{"method":"POST","path":"/v1/keys","summary":"Mint a scoped API key (its scopes must be a subset of your own).","scope":"keys:manage"},{"method":"GET","path":"/v1/keys","summary":"List your partner's keys (metadata only — the secret is never returned).","scope":"keys:manage"},{"method":"GET","path":"/v1/keys/{id}","summary":"Fetch one key's metadata.","scope":"keys:manage"},{"method":"DELETE","path":"/v1/keys/{id}","summary":"Revoke a key.","scope":"keys:manage"},{"method":"POST","path":"/v1/auth/codes","summary":"Request an email one-time code to provision an API key (no key required).","scope":null},{"method":"POST","path":"/v1/auth/keys","summary":"Exchange an email one-time code for a new API key (no key required).","scope":null},{"method":"GET","path":"/health","summary":"Liveness check.","scope":null},{"method":"GET","path":"/llms.txt","summary":"This API, explained for an agent (markdown).","scope":null},{"method":"GET","path":"/v1/schema/requisition.json","summary":"The requisition request body as a JSON Schema.","scope":null},{"method":"GET","path":"/v1/schema/enrichment.json","summary":"The enrichment request body as a JSON Schema.","scope":null}]}