GET /api/health
Returns a lightweight health payload for discovery and uptime checks.
- Use this for status link relations and simple liveness probes.
- The response is intentionally stable and machine-readable.
Agent Discovery
nocapmocap API documentation
This page documents the public discovery surface and the most commonly integrated authenticated endpoints for nocapmocap.
API catalog
https://www.nocapmocap.com/.well-known/api-catalog
OpenAPI description
https://www.nocapmocap.com/openapi.json
Health endpoint
https://www.nocapmocap.com/api/health
Protected resource metadata
https://www.nocapmocap.com/.well-known/oauth-protected-resource
OpenID Connect discovery
https://www.nocapmocap.com/.well-known/openid-configuration
OAuth authorization server metadata
https://www.nocapmocap.com/.well-known/oauth-authorization-server
Agent skills index
https://www.nocapmocap.com/.well-known/agent-skills/index.json
MCP server card
https://www.nocapmocap.com/.well-known/mcp/server-card.json
Authentication
Authenticated endpoints expect a bearer access token issued by the deployment's Supabase Auth server. The local well-known endpoints expose the protected resource metadata plus OIDC and OAuth discovery documents that agents can use for automated setup.
Curated endpoints
Public
GET /api/explore
Lists community motions with filters, sorting, and cursor pagination.
- Supports category, characterType, search, sortBy, limit, offset, and cursor query parameters.
- Results are signed for public media access where required.
POST /api/generate
Starts a text-to-motion generation job for the signed-in user.
- Validated request fields include prompt, duration, cfgScale, optional motionId, optional characterType, optional lockRoot, and optional loop.
- Credits and admin bypass semantics stay enforced server-side.
GET /api/generate/{id}
Polls a generation by prediction identifier and returns generation assets when complete.
- Only the owner of the prediction can poll it.
- Responses include status and completed asset URLs when available.
GET /api/profile
Returns the current authenticated profile snapshot.
- This is the simplest authenticated route to verify bearer token wiring.
PATCH /api/profile
Updates the signed-in user profile name or email with server-side validation.
- OAuth-linked users cannot change their email through this route.
GET /api/library
Lists a user library with filtering, pagination, and optional pack metadata.
- Supports category, characterType, tag, search, source_type, includePackInfo, includeTotal, limit, offset, and cursor.
POST /api/polar/checkout-url
Creates a checkout session URL for plans or credit packs.
- Request bodies differentiate between recurring plans and one-time credit packs.