Update Instance

PATCH

instances

{instance_id}

curl -X PATCH https://api.chowder.dev/v1/instances/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "Authorization: Bearer chd_org_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-assistant-v2",
    "openclaw_config": {
      "agent": {
        "system_prompt": "You are a helpful coding assistant."
      }
    }
  }'

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "organization_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "my-assistant-v2",
  "status": "running",
  "model_provider": "anthropic",
  "sandbox_provider": "sandbox",
  "sandbox_id": "sb_abc123",
  "gateway_url": "https://sb-abc123-18789.preview.sandbox.app",
  "openclaw_version": "v1",
  "openclaw_config": {
    "agent": {
      "system_prompt": "You are a helpful coding assistant."
    }
  },
  "region": null,
  "error_message": null,
  "created_at": "2026-02-14T16:00:00.000000+00:00",
  "updated_at": "2026-02-14T17:00:00.000000+00:00"
}

Update an instance’s metadata or runtime configuration. If the instance is running and you change openclaw_config, the new config is pushed to the live sandbox immediately — the gateway hot-reloads config changes automatically.

Accepts an organization key (chd_org_*) or a scoped key (chd_sk_*) with configure permission on this instance.

Path Parameters

string

required

The ID of the instance to update.

Request Body

All fields are optional. Only include what you want to change.

string

New name for the instance. 1–128 characters.

object

OpenClaw configuration overrides. These are applied as dot-path key/value pairs via openclaw config set. If the instance is running, changes take effect immediately.

Response

Returns 200 OK with the updated instance object.

curl -X PATCH https://api.chowder.dev/v1/instances/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "Authorization: Bearer chd_org_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-assistant-v2",
    "openclaw_config": {
      "agent": {
        "system_prompt": "You are a helpful coding assistant."
      }
    }
  }'

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "organization_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "my-assistant-v2",
  "status": "running",
  "model_provider": "anthropic",
  "sandbox_provider": "sandbox",
  "sandbox_id": "sb_abc123",
  "gateway_url": "https://sb-abc123-18789.preview.sandbox.app",
  "openclaw_version": "v1",
  "openclaw_config": {
    "agent": {
      "system_prompt": "You are a helpful coding assistant."
    }
  },
  "region": null,
  "error_message": null,
  "created_at": "2026-02-14T16:00:00.000000+00:00",
  "updated_at": "2026-02-14T17:00:00.000000+00:00"
}

curl -X PATCH https://api.chowder.dev/v1/instances/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "Authorization: Bearer chd_org_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-assistant-v2",
    "openclaw_config": {
      "agent": {
        "system_prompt": "You are a helpful coding assistant."
      }
    }
  }'

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "organization_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "my-assistant-v2",
  "status": "running",
  "model_provider": "anthropic",
  "sandbox_provider": "sandbox",
  "sandbox_id": "sb_abc123",
  "gateway_url": "https://sb-abc123-18789.preview.sandbox.app",
  "openclaw_version": "v1",
  "openclaw_config": {
    "agent": {
      "system_prompt": "You are a helpful coding assistant."
    }
  },
  "region": null,
  "error_message": null,
  "created_at": "2026-02-14T16:00:00.000000+00:00",
  "updated_at": "2026-02-14T17:00:00.000000+00:00"
}

Overview

Organization

Instances

Channels

Skills

Files

API Keys

Subscription

Update Instance

Path Parameters

Request Body

Response

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response