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

# List agent regions

> The agent regions your organisation can create agents in: one row per region and
runtime, with its hosting and the place its agents run in. Send a `code` as an
agent's `region`. Agent region codes are not the gateway codes in the speech and
Context Router base URLs: LiveKit Cloud's end in `-livekit`, such as
`us-east-livekit`, and SLNG Managed's US East is `us-east-slng`.




## OpenAPI

````yaml /api-reference/agents/agents.oas.yaml get /v1/agents/regions
openapi: 3.0.3
info:
  title: SLNG Voice Agents API
  version: 1.0.0
  description: >
    Public API for managing Voice Agents, dispatching outbound calls, and
    creating web (non-telephony) sessions.


    Base URL: `https://api.agents.slng.ai`
  contact:
    name: SLNG Support
    email: support@slng.ai
servers:
  - url: https://api.agents.slng.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Agents
    description: Voice agent CRUD.
  - name: Versions
    description: Agent configuration version history and restore.
  - name: Calls
    description: Call dispatch and status.
  - name: Sessions
    description: Web (non-telephony) sessions.
paths:
  /v1/agents/regions:
    get:
      tags:
        - Agents
      summary: List agent regions
      description: >
        The agent regions your organisation can create agents in: one row per
        region and

        runtime, with its hosting and the place its agents run in. Send a `code`
        as an

        agent's `region`. Agent region codes are not the gateway codes in the
        speech and

        Context Router base URLs: LiveKit Cloud's end in `-livekit`, such as

        `us-east-livekit`, and SLNG Managed's US East is `us-east-slng`.
      operationId: listAgentRegions
      parameters:
        - name: orchestrator
          in: query
          required: false
          description: Only the regions this runtime runs in.
          schema:
            type: string
            enum:
              - livekit
              - pipecat
        - name: world_part
          in: query
          required: false
          description: >-
            Only the regions whose agents run in this place, a gateway code from
            Region availability. An unknown code returns an empty list.
          schema:
            type: string
            maxLength: 20
      responses:
        '200':
          description: Agent regions, in picker order.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentRegionsOut'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '422':
          description: An unknown `orchestrator`, or a `world_part` over 20 characters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    AgentRegionsOut:
      type: object
      additionalProperties: false
      required:
        - agent_regions
      properties:
        agent_regions:
          type: array
          items:
            $ref: '#/components/schemas/AgentRegion'
    ErrorResponse:
      type: object
      additionalProperties: true
      description: >
        Error payloads can vary depending on where the error is raised (edge
        gateway vs backend).


        Common shapes include:

        - `{ "error": "message" }`

        - `{ "detail": "message" }`

        - `{ "detail": [ { "loc": [...], "msg": "...", "type": "..." } ] }`
        (validation)
      properties:
        error:
          oneOf:
            - type: string
            - type: object
              description: >
                The agents API's error envelope: a `code`, a `message`, and for
                a

                validation error the `fields` at fault, each with its `path`.
              additionalProperties: true
        detail:
          oneOf:
            - type: string
            - type: array
              items:
                type: object
    AgentRegion:
      type: object
      additionalProperties: false
      required:
        - code
        - label
        - sort_order
        - is_default
        - hosting
        - orchestrator
        - world_part_code
        - world_part_label
      properties:
        code:
          type: string
          description: The agent region code, as an agent's `region` takes it.
          example: us-east-slng
        label:
          type: string
          example: US East
        sort_order:
          type: integer
          description: Position in the region picker; the list is sorted by it.
        is_default:
          type: boolean
          description: Whether this is the default agent region.
        hosting:
          type: string
          enum:
            - slng
            - livekit_cloud
          description: >-
            Who runs this region's workers for your organisation, SLNG Managed
            or LiveKit Cloud.
        orchestrator:
          type: string
          enum:
            - livekit
            - pipecat
          description: >-
            The runtime this row is for. A region that runs both has a row for
            each.
        world_part_code:
          type: string
          description: >-
            The place an agent in this region runs in, a gateway code from
            Region availability. A project moves there when its agent is moved
            to this region.
          example: us-east
        world_part_label:
          type: string
          example: United States (East)
  responses:
    UnauthorizedError:
      description: Unauthorized.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            unauthorized:
              summary: Authentication failed
              value:
                detail: Authentication is required for this endpoint.
    ForbiddenError:
      description: Forbidden.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            forbidden:
              summary: Access denied
              value:
                detail: You do not have access to this resource.
    InternalServerError:
      description: Internal server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            internal-server-error:
              summary: Unexpected application error
              value:
                detail: An unexpected internal error occurred.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key

````

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