> ## 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 Skill Config

> Update the configuration for an installed skill.

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

<ParamField path="instance_id" type="string" required>
  The ID of the instance.
</ParamField>

<ParamField path="skill_name" type="string" required>
  The name of the skill to configure.
</ParamField>

## Body Parameters

<ParamField body="enabled" type="boolean">
  Enable or disable the skill without uninstalling it.
</ParamField>

<ParamField body="apiKey" type="string">
  Set an API key for the skill, if it requires one.
</ParamField>

<ParamField body="env" type="object">
  Environment variables to set for the skill. Keys are variable names, values are strings.
</ParamField>

<ParamField body="config" type="object">
  Skill-specific configuration options. The shape of this object depends on the skill.
</ParamField>

## Response

Returns `204 No Content` on success.

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  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
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```text 204 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  No Content
  ```
</ResponseExample>