curl -X POST 'https://api.elevenlabs.io/v1/convai/secrets' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "string",
  "name": "string",
  "value": "string"
}'

# POST /v1/convai/secrets (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Create Convai Workspace Secret

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/convai/secrets' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"type":"string","name":"string","value":"string"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| type | body | string | Yes | Request body field type. |
| name | body | string | Yes | Request body field name. |
| value | body | string | Yes | Request body field value. |

## Response (200 OK)
{"type":"string","secret_id":"string","name":"string"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

/v1/convai/secrets

ElevenLabs API

Create Convai Workspace Secret

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 205 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/convai/secrets' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "type": "string",  "name": "string",  "value": "string"}'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
type	body	string	Yes	Request body field type.
name	body	string	Yes	Request body field name.
value	body	string	Yes	Request body field value.

Response 200 OK

{
  "type": "string",
  "secret_id": "string",
  "name": "string"
}