Skip to main content
PATCH
/
v1
/
instances
/
{instance_id}
/
skills
/
{skill_name}
curl -X PATCH https://api.chowder.dev/v1/instances/ins_abc123/skills/web-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "env": {
      "SEARCH_API_KEY": "sk-new-key..."
    },
    "config": {
      "max_results": 5
    }
  }'

No Content
Updates the configuration of an installed skill. You can enable or disable it, set an API key, update environment variables, or adjust skill-specific config — all in a single call. Only the fields you include will be updated.

​
Authentication

Requires an org-level API key or a scoped token with the configure permission.

​
Path Parameters

​
instance_id
string
required
The ID of the instance.
​
skill_name
string
required
The name of the skill to configure.

​
Body Parameters

​
enabled
boolean
Enable or disable the skill without uninstalling it.
​
apiKey
string
Set an API key for the skill, if it requires one.
​
env
object
Environment variables to set for the skill. Keys are variable names, values are strings.
​
config
object
Skill-specific configuration options. The shape of this object depends on the skill.

​
Response

Returns 204 No Content on success. 
curl -X PATCH https://api.chowder.dev/v1/instances/ins_abc123/skills/web-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "env": {
      "SEARCH_API_KEY": "sk-new-key..."
    },
    "config": {
      "max_results": 5
    }
  }'

No Content