Interactive playground

Try live requests from generated OpenAPI endpoint pages.

Bearer auth

Use legacy API keys or platform-minted JWTs with the same Authorization header.

Entity lifecycle

Create entities from constitution YAML and manage versioned state changes.

Agent-safe governance

Create proposals when actions require policy review or escalation.
The OpenAPI specification lives at /openapi.json. Mintlify uses it to generate the API playground, request builders, parameter tables, response schemas, and SDK examples.

​
Base URL

https://api.orgs.sh

​
Authentication model

Protected routes require a bearer token:
​
Authorization
string
required
Bearer credential. The server accepts legacy Orgs API keys and platform-minted JWTs.
curl -sS https://api.orgs.sh/v1/entities \
  -H "authorization: Bearer $ORGS_API_KEY"

​
Main resources

Bootstrap API-key access with POST /v1/accounts. Store the returned raw key immediately.
Account-owned legal/operational containers created from constitution YAML.
Governance requests for spend, agent hiring, dissolution, and policy-controlled actions.
Filing state transitions and status polling for Wyoming DAO LLC formation.
Subscription, usage, upgrade, and webhook endpoints.

​
Response envelope

Successful responses return resource-specific JSON. Errors return:
​
error
string
required
Human-readable error message. Agents should preserve this message with the HTTP status and request intent.

​
Agent guidance

Agents must not use the playground or API to bypass constitution thresholds. If an action has legal, treasury, hiring, amendment, or dissolution consequences, create a proposal or escalate to a human.