> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chowder.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Organization

> Update your organization's name or model provider API keys.

Update your organization settings. You can change the name, add model provider API keys, or remove existing ones. All fields are optional — only include what you want to change.

<Note>
  Requires an **organization key** (`chd_org_*`). Scoped keys cannot access this endpoint.
</Note>

## Request Body

<ParamField body="name" type="string">
  New name for your organization. 1–128 characters.
</ParamField>

<ParamField body="model_api_keys" type="object">
  A map of provider name to API key. Keys are **merged** with your existing configuration — you don't need to resend providers you've already set up.

  Set a provider's value to an empty string `""` to remove it.

  Supported providers: `anthropic`, `openai`, `gemini`.
</ParamField>

## Response

Returns `200 OK` with the updated organization object.

<ResponseField name="id" type="string">Unique organization ID (UUID).</ResponseField>
<ResponseField name="name" type="string">Organization name.</ResponseField>
<ResponseField name="model_providers" type="string[]">Providers with active API keys. Actual keys are never returned.</ResponseField>
<ResponseField name="subscription_tier" type="string">Current plan.</ResponseField>
<ResponseField name="instance_limit" type="integer">Max active instances allowed.</ResponseField>
<ResponseField name="instance_count" type="integer">Current active instance count.</ResponseField>
<ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
<ResponseField name="updated_at" type="string">ISO 8601 timestamp.</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  curl -X PATCH https://api.chowder.dev/v1/organization \
    -H "Authorization: Bearer chd_org_abc123..." \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Acme Corp (Renamed)",
      "model_api_keys": {
        "anthropic": "sk-ant-api03-...",
        "openai": "sk-proj-..."
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Acme Corp (Renamed)",
    "model_providers": ["anthropic", "openai"],
    "subscription_tier": "shrimp",
    "instance_limit": 1,
    "instance_count": 1,
    "created_at": "2026-02-14T12:00:00.000000+00:00",
    "updated_at": "2026-02-14T15:00:00.000000+00:00"
  }
  ```
</ResponseExample>