# Organizations (/docs/api/reference/organizations)



Run each customer as an isolated [child organization](/docs/api/concepts/organizations): create and govern them, mint per-child keys, fund and cap their wallets, and resolve the calling key back to its org. The control-plane calls require the `org:admin` scope.

## Lifecycle [#lifecycle]

<Cards>
  <Card title="Create an organization" href="/docs/api/reference/organizations/create-organization" description="Provision an isolated child org under your parent - one per customer." />

  <Card title="List organizations" href="/docs/api/reference/organizations/list-organizations" description="Cursor-paginated list of your child orgs." />

  <Card title="Get an organization" href="/docs/api/reference/organizations/get-organization" description="One child org plus its credit + project summary." />

  <Card title="Update an organization" href="/docs/api/reference/organizations/patch-organization" description="Edit name, metadata (Stripe-merge), and billing email." />

  <Card title="Suspend" href="/docs/api/reference/organizations/suspend-organization" description="Reversible kill switch — pause a child without deleting it." />

  <Card title="Resume" href="/docs/api/reference/organizations/resume-organization" description="Lift a suspension and return the child to active." />

  <Card title="Archive" href="/docs/api/reference/organizations/archive-organization" description="Terminal offboard — reclaims unspent credits, revokes child keys." />

  <Card title="Migrate projects" href="/docs/api/reference/organizations/migrate" description="Move existing projects into newly-created child orgs." />
</Cards>

## Credits [#credits]

<Cards>
  <Card title="Child wallet" href="/docs/api/reference/organizations/credits/get-credits" description="A child org's balance and spendable available." />

  <Card title="Child credit events" href="/docs/api/reference/organizations/credits/list-events" description="The child's ledger, including parent→child allocations." />

  <Card title="Allocate credits" href="/docs/api/reference/organizations/credits/allocate" description="Fund a child from your parent wallet - idempotent." />

  <Card title="Credit config" href="/docs/api/reference/organizations/credit-config" description="Set the child's monthly cap and parent-funded auto-refill." />
</Cards>

## Keys & identity [#keys--identity]

<Cards>
  <Card title="Whoami" href="/docs/api/reference/organizations/whoami" description="Resolve the calling key to its org, scopes, parent org, and credit balance." />

  <Card title="Mint a child key" href="/docs/api/reference/organizations/api-keys/mint" description="Issue an API key for one of your child organizations - secret shown once." />

  <Card title="List child keys" href="/docs/api/reference/organizations/api-keys/list" description="Masked view of every key on a child org." />

  <Card title="Rotate a child key" href="/docs/api/reference/organizations/api-keys/rotate" description="Zero-downtime secret rollover with a 24h grace window." />

  <Card title="Delete a child key" href="/docs/api/reference/organizations/api-keys/delete" description="Immediate revoke, no grace." />
</Cards>