---
title: "List Environment Variables"
method: GET
path: "/v1/convai/environment-variables"
tags: ["Agents Platform"]
---

# List Environment Variables

`GET /v1/convai/environment-variables`

List all environment variables for the workspace with optional filtering

## Query parameters

- `cursor` string, nullable — Pagination cursor from previous response
- `page_size` integer — Number of items to return (1-100)
- `label` string, nullable — Filter by exact label match
- `environment` string, nullable — Filter to only return variables that have this environment. When specified, the values dict in the response will only contain this environment.
- `type` 'string' | 'secret' | 'auth_connection', nullable — Filter by variable type

## 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

- EnvironmentVariablesListResponse
  - `environment_variables` EnvironmentVariableResponse[], required
    - `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
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Other responses

- `400` — Invalid environment filter
- `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/revisions/b96b80bcbb83/schema)