---
title: "Update A Registered External Chat Completions Agent."
method: PATCH
path: "/v1/agents/external-chat/{id}"
tags: ["External Chat Agents"]
---

# Update A Registered External Chat Completions Agent.

`PATCH /v1/agents/external-chat/{id}`

## Path parameters

- `id` string, required

## Request body

- PatchExternalChatAgent
  - `title` string, nullable
  - `description` string, nullable
  - `tags` string[], nullable
  - `name` string, nullable
  - `api_url` string, nullable
  - `auth_scheme` 'BEARER_TOKEN' | 'API_KEY' | 'NONE'
  - `auth_config` object, nullable
  - `chat_params` object, nullable
  - `instructions` string, nullable
  - `nickname` string, nullable
  - `connection_id` string, nullable
  - `config` ExternalChatAgentConfig
    - `hidden` boolean
    - `enable_cot` boolean
  - `context_access_enabled` boolean, nullable — Enable access to context variables for this agent
  - `context_variables` string[], nullable — List of context variable names that this agent can access

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ibm/apis/wxo-server-api.md) · [All operations](https://skmtc.net/ibm/apis/wxo-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/wxo-server-api/revisions/82c114c37196/schema)