{"status":"ok","name":"KONDEVS API","version":"1.1.0","docs":"https://www.kondevs.com/developers/","openapi":"https://www.kondevs.com/openapi.json","api_catalog":"https://www.kondevs.com/.well-known/api-catalog","auth":"https://www.kondevs.com/auth.md","errors":"Every /api/* error is JSON: { status: \"error\", code, message, hint, docs }. OAuth endpoints use the RFC 6749 format, /mcp and /api/a2a JSON-RPC 2.0.","versioning":"Send X-Content-API-Version: 1 to lock the major version of the Content API; another major answers 400 unsupported_version.","endpoints":[{"method":"GET","path":"/api/","auth":"none","description":"This index: every endpoint with its method, access and purpose, and where the docs are."},{"method":"GET","path":"/api/health","auth":"none","description":"Liveness probe."},{"method":"POST","path":"/mcp","auth":"none","description":"MCP server (JSON-RPC 2.0, Streamable HTTP): search and read articles, list services, company facts."},{"method":"POST","path":"/api/a2a","auth":"none","description":"A2A agent (JSON-RPC 2.0, message/send)."},{"method":"GET","path":"/api/content/version","auth":"none","description":"Content API version and the rendering capabilities of this site."},{"method":"GET","path":"/api/content/catalog","auth":"token (content:read)","description":"Published articles, categories and tags, 100 articles a page unless ?limit= says otherwise (at most 500); next_cursor and a Link rel=\"next\" header name the same next page."},{"method":"POST","path":"/api/content/catalog","auth":"token (content:write)","description":"Rebuild the article lists and counts from the stored articles after parallel writes: a dry run answering each change (changes[]) and the catalog it leaves; ?apply=1 writes them."},{"method":"POST","path":"/api/content/","auth":"token (content:write)","description":"Publish an article; covers are optional; dry_run validates without storing (a taken slug answers 409); accepts Idempotency-Key."},{"method":"GET","path":"/api/content/{slug}","auth":"none","description":"One article: 200 when it is published, 404 when there is none; a draft answers 200 only with a content key."},{"method":"PUT","path":"/api/content/{slug}","auth":"token (content:write)","description":"Update an article: each field the payload sends replaces the stored one, a field it leaves out keeps its value (the FAQ, key takeaways and sources too; an empty list clears one)."},{"method":"DELETE","path":"/api/content/{slug}","auth":"token (content:write)","description":"Unpublish an article."},{"method":"GET","path":"/api/content/tags","auth":"token (content:read)","description":"The tags of the published articles: the same list as the catalog's."},{"method":"POST","path":"/api/content/images","auth":"token (content:write)","description":"Upload one image for an article (multipart/form-data: file, slug, variant; at most 10 MB); the answer names its URL. dry_run checks without storing."},{"method":"POST","path":"/api/oauth/token","auth":"client","description":"OAuth 2.0 client_credentials: exchange an issued secret for a 1-hour bearer token (RFC 6749 errors)."},{"method":"GET","path":"/api/oauth/register","auth":"none","description":"How to obtain credentials (issued by human review, no self-service; the sandbox issues its own test keys)."},{"method":"POST","path":"/api/oauth/register","auth":"none","description":"Production: answers like GET, registration is manual, no client is created and no credential is issued. On the sandbox server (kondevs-sandbox.pages.dev) a key is issued: 201, a test write key valid 7 days."},{"method":"POST","path":"/api/contact","auth":"none","description":"The contact form of /contacts/ (CSRF token, honeypot, consent, rate limit; Turnstile only when configured); answers { success, message }. While outbound mail is not configured it answers success: false and names info@kondevs.com."}]}