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

# List runtimes

> List execution runtimes and their compatible model references for the current organization.



## OpenAPI

````yaml https://api.tembo.io/public-api/openapi/public get /v1/runtimes
openapi: 3.1.0
info:
  title: Tembo Public API
  description: >-
    Manage agents, sessions, repositories, and organization resources with the
    Tembo API.
  version: 1.0.0
servers:
  - url: https://api.tembo.io
    description: Tembo API
  - url: https://{deployment-origin}/api/public-api
    description: Self-hosted Tembo
    variables:
      deployment-origin:
        default: tembo.example.com
        description: Hostname of your self-hosted Tembo deployment
security: []
paths:
  /v1/runtimes:
    get:
      tags:
        - Runtimes
      summary: List runtimes
      description: >-
        List execution runtimes and their compatible model references for the
        current organization.
      operationId: listRuntimes
      parameters:
        - in: query
          name: cursor
          schema:
            type: string
            enum:
              - claudeCode
              - codex
              - opencode
              - cursor
              - amp
              - fx
              - pi
          description: >-
            Continuation cursor from the previous response nextCursor. Omit for
            the first page; null nextCursor means there are no more pages.
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
          description: >-
            Maximum number of items to return in one page. Use nextCursor from
            the response to fetch more items.
      responses:
        '200':
          description: List runtimes
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          enum:
                            - claudeCode
                            - codex
                            - opencode
                            - cursor
                            - amp
                            - fx
                            - pi
                        displayName:
                          type: string
                        defaultModelName:
                          type: string
                          minLength: 1
                          maxLength: 200
                        requiresApiKey:
                          type: boolean
                        hasApiKey:
                          type: boolean
                        runCapabilities:
                          type: object
                          properties:
                            modes:
                              type: array
                              items:
                                type: string
                                enum:
                                  - normal
                                  - planning
                            speeds:
                              type: array
                              items:
                                type: string
                                enum:
                                  - normal
                                  - fast
                                  - ultrafast
                            supportsGoals:
                              type: boolean
                            ultracodeModels:
                              type: array
                              items:
                                type: string
                              description: >-
                                Models that support ultracode workflow
                                orchestration.
                          required:
                            - modes
                            - speeds
                            - supportsGoals
                            - ultracodeModels
                          additionalProperties: false
                        availability:
                          oneOf:
                            - type: object
                              properties:
                                status:
                                  type: string
                                  const: available
                              required:
                                - status
                              additionalProperties: false
                            - type: object
                              properties:
                                status:
                                  type: string
                                  const: unavailable
                                code:
                                  type: string
                                  enum:
                                    - plan_required
                                    - missing_credentials
                                reason:
                                  type: string
                              required:
                                - status
                                - code
                                - reason
                              additionalProperties: false
                        compatibleModels:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                minLength: 1
                                maxLength: 200
                              label:
                                type: string
                              provider:
                                type: string
                              inferenceSource:
                                type:
                                  - string
                                  - 'null'
                                description: >-
                                  Selected subscription, API provider, or CLI
                                  API billing source for this runtime and model.
                              isDefault:
                                type: boolean
                              isPlatformDefault:
                                type: boolean
                              reasoningLevels:
                                type: array
                                items:
                                  type: string
                              availability:
                                oneOf:
                                  - type: object
                                    properties:
                                      status:
                                        type: string
                                        const: available
                                    required:
                                      - status
                                    additionalProperties: false
                                  - type: object
                                    properties:
                                      status:
                                        type: string
                                        const: unavailable
                                      code:
                                        type: string
                                        enum:
                                          - model_disabled
                                          - plan_required
                                          - missing_credentials
                                          - unsupported_provider
                                          - chatgpt_not_connected
                                          - supergrok_not_connected
                                          - claude_subscription_not_connected
                                      reason:
                                        type: string
                                    required:
                                      - status
                                      - code
                                      - reason
                                    additionalProperties: false
                            required:
                              - name
                              - label
                              - provider
                              - inferenceSource
                              - isDefault
                              - isPlatformDefault
                              - reasoningLevels
                              - availability
                            additionalProperties: false
                      required:
                        - name
                        - displayName
                        - defaultModelName
                        - requiresApiKey
                        - hasApiKey
                        - runCapabilities
                        - availability
                        - compatibleModels
                      additionalProperties: false
                  nextCursor:
                    type:
                      - string
                      - 'null'
                    enum:
                      - claudeCode
                      - codex
                      - opencode
                      - cursor
                      - amp
                      - fx
                      - pi
                      - null
                required:
                  - items
                  - nextCursor
                additionalProperties: false
        '400':
          description: Invalid request, cursor, or caller scope
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                additionalProperties: false
      security:
        - apiKey: []
      x-codeSamples:
        - lang: typescript
          label: TypeScript SDK
          source: |
            import Tembo from '@tembo-io/sdk';

            const client = new Tembo();

            const runtime = await client.runtimes.list({
              limit: 50,
            });
        - lang: rust
          label: Rust SDK
          source: |
            use tembo_rs::*;

            let client = Tembo::from_env()?;

            let response = client.runtimes().list().send().await?;
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer

````

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