> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# List environments

> List the workspace environments, including 'production'.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/convai/environments
openapi: 3.1.0
info:
  title: Threetone API
  description: >-
    APIs for the Threetone Agents Platform and shared workspace resources.
    Authenticate programmatic requests with an API key in the x-api-key header.
  version: '1.0'
servers:
  - url: https://api.threetone.in
    description: Production
security: []
paths:
  /v1/convai/environments:
    get:
      tags:
        - Agents Platform
      summary: List environments
      description: List the workspace environments, including 'production'.
      operationId: list_environments
      parameters:
        - name: x-api-key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Your API key for programmatic access. Send it in the x-api-key
              header; you can create and manage keys from the Developers page.
            title: X-Api-Key
          description: >-
            Your API key for programmatic access. Send it in the x-api-key
            header; you can create and manage keys from the Developers page.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnvironmentsListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    EnvironmentsListResponse:
      properties:
        environments:
          items:
            $ref: '#/components/schemas/EnvironmentResponse'
          type: array
          title: Environments
          description: >-
            All workspace environments, 'production' first. Variables without a
            value for an environment fall back to their production value.
      type: object
      required:
        - environments
      title: EnvironmentsListResponse
      example:
        environments:
          - name: production
            updated_at_unix_secs: 1714000000
          - created_by_user_id: user_7k2m9x
            name: staging
            updated_at_unix_secs: 1714003600
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    EnvironmentResponse:
      properties:
        name:
          type: string
          title: Name
          description: Name of the environment, e.g. 'staging'.
        updated_at_unix_secs:
          anyOf:
            - type: integer
            - type: 'null'
          title: Updated At Unix Secs
          description: >-
            When the environment was created or one of its values last changed.
            Unset when neither is known.
        created_by_user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Created By User Id
          description: Unset for 'production' and when the creator is not known.
      type: object
      required:
        - name
      title: EnvironmentResponse
      example:
        created_by_user_id: user_7k2m9x
        name: staging
        updated_at_unix_secs: 1714003600
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.