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

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.

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