API & developer documentation
Musikeando exposes a public HTTP API over the same origin as the site. Read endpoints require no credentials. The song-creation flow works with an anonymous guest session; purchasing requires an account.
Base URL
https://musikeando.comAuthentication
Authenticated calls use the Musikeando session cookie, set by the sign-in flow. Send cookies with the request. Endpoints that require a session answer 401 with a WWW-Authenticate: Bearer resource_metadata=... header pointing at the protected-resource metadata.
Full walkthrough: /auth.md
Endpoints
| Method | Path | Description | Auth |
|---|---|---|---|
| GET | /api/health | Service health probe. | none |
| GET | /api/pricing | Public first-purchase pricing catalog. | none |
| POST | /api/pricing | Validate a coupon or discount code. | none |
| GET | /api/occasions | Active gift occasions. | none |
| GET | /api/testimonials | Approved customer testimonials. | none |
| GET | /api/blog | Published blog posts for the current market. | none |
| POST | /api/contact | Send a contact message. | none |
| POST | /api/auth/register | Create an account. | none |
| POST | /api/songs/create | Start a personalized song order. | guest session |
| GET | /api/music/status/{taskId} | Check generation status. | guest session |
| POST | /api/payments/create-final-intent | Create a Stripe payment intent. | account |
Errors
{ "error": "Human-readable message", "details": null }Discovery documents
- /openapi.json β OpenAPI 3.1 description
- /.well-known/api-catalog β API catalog (RFC 9727)
- /.well-known/ard.json β Agentic resource discovery (ARD)
- /.well-known/agent-skills/index.json β Agent skills index
- /.well-known/agent-card.json β A2A agent card
- /.well-known/mcp/server-card.json β MCP server card
- /.well-known/mcp/docs/server-card.json β MCP documentation server card
- /.well-known/mcp β MCP server (Streamable HTTP, read-only catalog tools)
- /.well-known/mcp/docs β MCP documentation server
- /.well-known/oauth-protected-resource β Protected resource metadata (RFC 9728)
- /auth.md β auth.md β agent authentication
- /llms.txt β llms.txt
- /llms.md β llms.md
- /pricing.md β pricing.md
- /agents.md β agents.md β when to use this service
- /docs.md β this page as markdown
- /docs/llms.txt β developer llms.txt