---
title: "Changes to Get Convai Workspace Secrets"
method: GET
path: "/v1/convai/secrets"
---

# Changes to Get Convai Workspace Secrets

`GET /v1/convai/secrets`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 108 revisions.

- **2026-06-08** `37fac3c5a2d7`: 2 warning, 7 info
- **2026-04-03** `deb5e58ddddf`: 1 info
- **2026-02-08** `5b595807512c`: 1 breaking, 1 warning, 7 info
- **2025-05-16** `503db4198a44`: 1 info

## Changes

- **2026-06-08** `37fac3c5a2d7`: 2 warning, 7 info
  - removed the optional property `has_more` from the response with the `200` status
  - added the new `exotel` enum value to the `secrets/items/used_by/phone_numbers/items/provider` response property for the response status `200`
  - added the new optional `query` request parameter `dependency_limit`
  - added the new optional `query` request parameter `search`
  - added the optional property `secrets/items/used_by/agents_has_more` to the response with the `200` status
  - added the optional property `secrets/items/used_by/mcp_servers` to the response with the `200` status
  - added the optional property `secrets/items/used_by/phone_numbers_has_more` to the response with the `200` status
  - added the optional property `secrets/items/used_by/tools_has_more` to the response with the `200` status
  - added the required property `secrets/items/used_by/agents/items/oneOf[subschema #2: DependentUnknownAgentIdentifier]/id` to the response with the `200` status
- **2026-04-03** `deb5e58ddddf`: 1 info
  - added the required property `secrets/items/used_by/tools/items/oneOf[subschema #2: DependentUnknownToolIdentifier]/id` to the response with the `200` status
- **2026-02-08** `5b595807512c`: 1 breaking, 1 warning, 7 info
  - removed the required property `secrets/items/used_by/agent_tools` from the response with the `200` status
  - added the new `commenter` enum value to the `secrets/items/used_by/tools/items/oneOf[subschema #1: DependentAvailableToolIdentifier]/access_level` response property for the response status `200`
  - api operation id `Get_ConvAI_workspace_secrets_v1_convai_secrets_get` removed and replaced with `get_secrets_route`
  - api tag `Agents Platform` added
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `page_size`
  - added the optional property `has_more` to the response with the `200` status
  - added the optional property `next_cursor` to the response with the `200` status
  - added the required property `secrets/items/used_by/agents` to the response with the `200` status
- **2025-05-16** `503db4198a44`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/docs/v1/convai/secrets/get.md) - [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [Page](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/secrets/get)