API discovery

DemandOS API documentation for agents.

DemandOS publishes conservative discovery metadata for authenticated Hook Studio APIs. These endpoints describe the browser app surface; they do not create anonymous access to workspace data.

Discovery resources

API catalog: /.well-known/api-catalog
OpenAPI description: /.well-known/openapi.json
OAuth protected resource metadata: /.well-known/oauth-protected-resource
OIDC metadata delegated to Clerk: /.well-known/openid-configuration
Agent skills index: /.well-known/agent-skills/index.json

Authentication boundary

Clerk is the account and authentication authority for DemandOS. Protected workspace APIs require an authenticated DemandOS session and are scoped to the signed-in user's workspace access.

Public status endpoints

/healthz reports liveness.
/readyz reports readiness.

Operational limits

DemandOS does not expose private workspace, billing, or profile data through public discovery documents. The catalog is intended to help agents understand available interfaces before they attempt authenticated browser or API flows.