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

# Edit Agent

> Update an Agent. The most common use is assigning or unassigning Abilities.

<ParamField header="X-API-KEY" type="string" required>
  Your OpenHome API key.
</ParamField>

<ParamField body="matching_capabilities" type="integer[]">
  Full list of Ability (capability) IDs the Agent should have. This replaces the current list — send `[]` to unassign all.
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X PUT https://app.openhome.com/api/personalities/edit-personality/ \
    -H "X-API-KEY: YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{"matching_capabilities": [1, 2, 3]}'
  ```

  ```python Python theme={"system"}
  import requests

  requests.put(
      "https://app.openhome.com/api/personalities/edit-personality/",
      headers={"X-API-KEY": "YOUR_KEY"},
      json={"matching_capabilities": [1, 2, 3]},
  )
  ```
</RequestExample>