Sign Up

POST

organization

signup

curl -X POST https://api.chowder.dev/v1/organization/signup \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp"
  }'

{
  "organization": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Acme Corp",
    "model_providers": [],
    "subscription_tier": "shrimp",
    "instance_limit": 1,
    "instance_count": 0,
    "created_at": "2026-02-14T12:00:00.000000+00:00",
    "updated_at": "2026-02-14T12:00:00.000000+00:00"
  },
  "api_key": "chd_org_abc123def456ghi789jkl012mno345pqr678"
}

This is the starting point for using Chowder. Create an organization and you’ll receive an org-level API key (chd_org_*) that grants full access to everything under that org. No authentication is required for this endpoint — it’s how you get your first key.

Request Body

string

required

The name for your organization. Must be between 1 and 128 characters.

Response

Returns 201 Created with the new organization and your API key.

The api_key value is shown only once in this response. Store it somewhere safe — you won’t be able to retrieve it again.

object

The created organization.

Show Organization fields

string

Unique organization ID (UUID).

string

The org name you provided.

string[]

List of model providers with API keys configured. Empty initially.

string

Current plan. Defaults to "shrimp".

integer

Max number of active instances allowed.

integer

Current number of active instances.

string

ISO 8601 timestamp.

string

ISO 8601 timestamp.

string

Your org-level API key, prefixed with chd_org_. Use this as a Bearer token for all subsequent requests.

curl -X POST https://api.chowder.dev/v1/organization/signup \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp"
  }'

{
  "organization": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Acme Corp",
    "model_providers": [],
    "subscription_tier": "shrimp",
    "instance_limit": 1,
    "instance_count": 0,
    "created_at": "2026-02-14T12:00:00.000000+00:00",
    "updated_at": "2026-02-14T12:00:00.000000+00:00"
  },
  "api_key": "chd_org_abc123def456ghi789jkl012mno345pqr678"
}

curl -X POST https://api.chowder.dev/v1/organization/signup \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp"
  }'

{
  "organization": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Acme Corp",
    "model_providers": [],
    "subscription_tier": "shrimp",
    "instance_limit": 1,
    "instance_count": 0,
    "created_at": "2026-02-14T12:00:00.000000+00:00",
    "updated_at": "2026-02-14T12:00:00.000000+00:00"
  },
  "api_key": "chd_org_abc123def456ghi789jkl012mno345pqr678"
}

Overview

Organization

Instances

Channels

Skills

Files

API Keys

Subscription

Request Body

Response

​Request Body

​Response

Request Body

Response