---
title: "Update an assistant"
method: PATCH
path: "/assistants/{assistant_name}"
tags: ["Manage Assistants"]
---

# Update an assistant

`PATCH /assistants/{assistant_name}`

Update an existing assistant. You can modify the assistant's instructions.

For guidance and examples, see [Manage assistants](https://docs.pinecone.io/guides/assistant/manage-assistants#add-instructions-to-an-assistant).

## Path parameters

- `assistant_name` string, required

## Headers

- `X-Pinecone-Api-Version` string, required

## Request body

- AssistantControlUpdateAssistantRequest — The configuration updates for the assistant.
  - `instructions` string, nullable — Guidance applied to all responses generated by the assistant. Maximum 16 KB.
  - `metadata` object, nullable — Optional metadata associated with the assistant. Metadata is a JSON object that can store custom organizational data, tags, and attributes. Maximum size is 16KB.

## Response `200`

Update request successful.

- AssistantControlUpdateAssistantResponse
  - `assistant_name` string — The assistant name.
  - `instructions` string — Guidance applied to all responses generated by the assistant.
  - `metadata` object — Optional metadata associated with the assistant. Metadata is a JSON object that can store custom organizational data, tags, and attributes.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Assistant not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/pinecone/apis/pinecone-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-api/versions/35876583485d/schema)