Pet Anthemz API

Pet Anthemz exposes a REST API at /api/v1/ for creating and managing custom AI pet songs.

Discovery

• API Catalog (RFC 9727)
• OpenAPI specification
• llms.txt
• MCP Server Card
• auth.md — agent registration

Public reference endpoints (no auth)

• GET /api/v1/pet-types/ — supported pet types
• GET /api/v1/genres/ — music genres
• GET /api/v1/config/ — pricing and availability
• POST /api/v1/songs/email-create/ — email-gated create (ChatGPT / guest; no JWT; returns listen_url)
• GET /api/v1/songs/<uuid>/public-status/ — public status + listen_url

Authenticated endpoints

Register or login to receive a Bearer JWT, then create songs, manage pets, and purchase downloads.

• POST /api/v1/auth/register/
• POST /api/v1/auth/login/
• POST /api/v1/auth/magic-link/request/
• GET/POST /api/v1/songs/

For AI agents

Prefer the MCP endpoint at /mcp with tools create_song and get_song_status (email-only identity). Purchases stay on the website. See create-pet-song skill and auth.md.