---
title: "Get Environment Variable"
method: GET
path: "/v1/convai/environment-variables/{env_var_id}"
tags: ["Agents Platform"]
---

# Get Environment Variable

`GET /v1/convai/environment-variables/{env_var_id}`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/convai/environment-variables/{env_var_id}`
- Auth: none declared

Get a specific environment variable by ID

## Path parameters

- `env_var_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.

## Response `200`

Successful Response

- EnvironmentVariableResponse
  - `label` string, required
  - `created_at_unix_secs` integer, required
  - `updated_at_unix_secs` integer, required
  - `created_by_user_id` string, nullable
  - `type` 'string' | 'secret' | 'auth_connection', required
  - `id` string, required
  - `workspace_id` string, required
  - `values` union, required
    - object
    - object
    - object

## Other responses

- `404`: Environment variable not found
- `422`: Validation Error

## Changes

- **2026-04-03** `deb5e58ddddf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/environment-variables/:env_var_id/get.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)
