---
title: "Update Convai Workspace Secret"
method: PATCH
path: "/v1/convai/secrets/{secret_id}"
tags: ["Agents Platform"]
---

# Update Convai Workspace Secret

`PATCH /v1/convai/secrets/{secret_id}`

Update an existing secret for the workspace

## Path parameters

- `secret_id` string, required

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- PatchWorkspaceSecretRequest
  - `type` 'update', required
  - `name` string, required
  - `value` string, required

## Response `200`

Successful Response

- PostWorkspaceSecretResponseModel
  - `type` 'stored', required
  - `secret_id` string, required
  - `name` string, required

## Other responses

- `422` — Validation Error

---

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