API docs

Codex Pets API docs

Public agent/developer contract endpoints for approved pet discovery, install instructions, share snippets, MCP tools, pet generation requests, and moderated pet submissions.

OpenAPI spec Developer portal

Public endpoints

GET /api/manifest
GET /api/manifest.toon
GET /api/pets?q=<query>&kind=all|creature|object|character&tags=<tags>
GET /api/pets.toon
GET /api/pets/<slug>
GET /api/pets/<slug>.toon
GET /api/tags
GET /api/tags.toon
GET /api/pets/<slug>/share
GET /api/pets/<slug>/install
POST /api/generation-requests
POST /api/submissions/register
POST /mcp

Examples

curl -s https://pets.ydb-qdrant.tech/api/manifest
curl -s "https://pets.ydb-qdrant.tech/api/pets?q=space&kind=creature"
curl -s https://pets.ydb-qdrant.tech/api/pets/{slug}/install
codex mcp add codexPets --url https://pets.ydb-qdrant.tech/mcp

Authentication

Public read endpoints are unauthenticated. AppSessionCookie and ProxyBasic are documented in the OpenAPI security schemes for browser account flows and trusted proxy deployments. OAuth 2.0 and webhooks are not currently available. Public metric mutation and download redirect routes are outside this OpenAPI contract.