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

# Get many prompts

> Reads several prompts by ID in one call. An ID that matches no prompt in the environment is reported instead of failing the request.



## OpenAPI

````yaml /specs-prettified/realtime/openapi.stable.json post /v1/stable/prompt/get-many
openapi: 3.0.0
info:
  title: Realtime
  description: Realtime gateway API service
  version: 1.0.0
  contact: {}
servers:
  - url: https://realtime-api.voiceflow.com
security: []
tags: []
paths:
  /v1/stable/prompt/get-many:
    post:
      tags:
        - Prompt
      summary: Get many prompts
      description: Reads several prompts by ID in one call. An ID that matches no
        prompt in the environment is reported instead of failing the request.
      operationId: StablePromptController_getMany
      parameters:
        - name: projectID
          required: true
          in: query
          schema:
            type: string
            description: The ID of the project to operate on.
        - name: environmentAlias
          required: true
          in: query
          schema:
            type: string
            description: The alias of the environment to operate on (e.g. `main`).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/StablePromptGetManyRequest"
      responses:
        "200":
          description: Returns the prompts found, in request order, and `missing`, the
            requested IDs that match no prompt in this environment.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablePromptReadManyResponse"
          x-vf-doc:
            description: Returns the prompts found, in request order, and `missing`, the
              requested IDs that match no prompt in this environment.
      security:
        - token: []
components:
  schemas:
    StablePromptGetManyRequest:
      type: object
      properties:
        ids:
          minItems: 1
          type: array
          items:
            type: string
          description: Prompt IDs to read. Duplicates are ignored; at most 50 distinct IDs.
      required:
        - ids
      additionalProperties: false
    StablePromptReadManyResponse:
      type: object
      properties:
        prompts:
          type: array
          items:
            $ref: "#/components/schemas/StablePrompt"
          description: The prompts found, in request order.
        missing:
          type: array
          items:
            type: string
          description: Requested IDs that match no prompt in this environment, in request
            order.
      required:
        - prompts
        - missing
    StablePrompt:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        system:
          $ref: "#/components/schemas/VariableReferenceString"
        settings:
          $ref: "#/components/schemas/PromptSettings"
        createdAt:
          type: string
          format: date-time
          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        updatedAt:
          type: string
          format: date-time
          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        createdByID:
          type: number
          description: The user who created the prompt.
        updatedByID:
          type: number
          description: The user who last changed the prompt, its settings or its system
            text.
      required:
        - id
        - name
        - system
        - settings
        - createdAt
        - updatedAt
        - createdByID
        - updatedByID
    VariableReferenceString:
      type: string
      description: Plain text; markdown is not interpreted. {variable_name} inserts a
        variable or entity, {variable_name.path} a field of a variable. Escape a
        literal { or \ with a backslash. A name matching neither is stored as
        literal text and reported in unresolvedReferences; secrets are not
        available here.
    PromptSettings:
      type: object
      properties:
        model:
          allOf:
            - $ref: "#/components/schemas/AIModel"
        maxTokens:
          type: number
        temperature:
          type: number
        responseFormat:
          type: string
        reasoningEffort:
          nullable: true
          allOf:
            - $ref: "#/components/schemas/AIReasoningEffort"
        serviceTier:
          description: "The service tier to request from models that support it.
            `priority` is faster processing: faster responses at a higher credit
            cost. When unset, the deprecated project-level `priorityProcessing`
            setting applies."
          nullable: true
          allOf:
            - $ref: "#/components/schemas/AIParamsServiceTier"
        useStructuredOutput:
          type: boolean
    AIModel:
      type: string
      enum:
        - gpt-3.5-turbo-1106
        - gpt-3.5-turbo
        - gpt-4
        - gpt-4o
        - gpt-4o-mini
        - gpt-4.1-2025-04-14
        - gpt-4.1-mini-2025-04-14
        - gpt-4.1-nano-2025-04-14
        - gpt-o3-mini
        - o3-2025-04-16
        - o4-mini-2025-04-16
        - gpt-5
        - gpt-5-mini
        - gpt-5-nano
        - gpt-5.2
        - gpt-5.4
        - gpt-5.4-mini
        - gpt-5.5
        - gpt-5.6-sol
        - gpt-5.6-terra
        - gpt-5.6-luna
        - gpt-6-sol
        - gpt-6-luna
        - gpt-6.1-sol
        - gpt-realtime
        - gpt-live-1
        - claude-4-opus
        - claude-4-sonnet
        - claude-4.5-sonnet
        - claude-4.6-sonnet
        - claude-4.5-haiku
        - claude-4.5-opus
        - claude-4.7-opus
        - bedrock-claude-4-sonnet
        - bedrock-claude-4.5-sonnet
        - bedrock-claude-4.6-sonnet
        - bedrock-claude-5-sonnet
        - bedrock-claude-5.5-sonnet
        - bedrock-claude-4.5-haiku
        - bedrock-claude-4.5-opus
        - bedrock-claude-4.7-opus
        - bedrock-claude-4.8-opus
        - voiceflow-core-4.0
        - voiceflow-core-4.1
        - voiceflow-core-4.2
        - voiceflow-flash-4.2
        - gemini-2.5-pro
        - gemini-2.5-flash
        - gemini-live-2.5-flash
        - gemini-3-flash
        - gemini-3.5-flash
        - gemini-3.1-pro
        - gpt-oss-20b
        - gpt-oss-120b
        - llama-guard-4
        - llama-3.1-instant
        - llama-3.3-versatile
        - qwen3.6-27b
        - grok-4.6
        - voiceflow-flash-4.1
        - kimi-k3
        - gemini-flash-2
        - gpt-4-turbo
        - claude-3.5-haiku
        - claude-3-opus
        - claude-3.7-sonnet
        - claude-v2
        - llama-3.2-1b-preview
        - gemini-pro-1.5
        - claude-3-haiku
        - claude-3-sonnet
        - text-davinci-003
        - claude-v1
        - claude-instant-v1
        - deep-seek-r1-distill-llama-70B
        - claude-3.5-sonnet
      x-enumNames:
        - GPT_3_5_TURBO_1106
        - GPT_3_5_TURBO
        - GPT_4
        - GPT_4_O
        - GPT_4_O_MINI
        - GPT_4_1
        - GPT_4_1_MINI
        - GPT_4_1_NANO
        - GPT_O_3_MINI
        - GPT_O_3
        - GPT_O_4_MINI
        - GPT_5
        - GPT_5_MINI
        - GPT_5_NANO
        - GPT_5_2
        - GPT_5_4
        - GPT_5_4_MINI
        - GPT_5_5
        - GPT_5_6_SOL
        - GPT_5_6_TERRA
        - GPT_5_6_LUNA
        - GPT_6_SOL
        - GPT_6_LUNA
        - GPT_6_1_SOL
        - GPT_REALTIME
        - GPT_LIVE_1
        - CLAUDE_4_OPUS
        - CLAUDE_4_SONNET
        - CLAUDE_4_5_SONNET
        - CLAUDE_4_6_SONNET
        - CLAUDE_4_5_HAIKU
        - CLAUDE_4_5_OPUS
        - CLAUDE_4_7_OPUS
        - BEDROCK_CLAUDE_4_SONNET
        - BEDROCK_CLAUDE_4_5_SONNET
        - BEDROCK_CLAUDE_4_6_SONNET
        - BEDROCK_CLAUDE_5_SONNET
        - BEDROCK_CLAUDE_5_5_SONNET
        - BEDROCK_CLAUDE_4_5_HAIKU
        - BEDROCK_CLAUDE_4_5_OPUS
        - BEDROCK_CLAUDE_4_7_OPUS
        - BEDROCK_CLAUDE_4_8_OPUS
        - VOICEFLOW_CORE_4_0
        - VOICEFLOW_CORE_4_1
        - VOICEFLOW_CORE_4_2
        - VOICEFLOW_FLASH_4_2
        - GEMINI_2_5_PRO
        - GEMINI_2_5_FLASH
        - GEMINI_LIVE_2_5_FLASH
        - GEMINI_3_FLASH
        - GEMINI_3_5_FLASH
        - GEMINI_3_1_PRO
        - GPT_OSS_20_B
        - GPT_OSS_120_B
        - LLAMA_GUARD_4
        - LLAMA_3_1_INSTANT
        - LLAMA_3_3_VERSATILE
        - QWEN_3_6_27_B
        - GROK_4_6
        - VOICEFLOW_FLASH_4_1
        - KIMI_K_3
        - GEMINI_FLASH_2
        - GPT_4_TURBO
        - CLAUDE_3_5_HAIKU
        - CLAUDE_3_OPUS
        - CLAUDE_3_7_SONNET
        - CLAUDE_V_2
        - LLAMA_3_2_1_B_PREVIEW
        - GEMINI_PRO_1_5
        - CLAUDE_3_HAIKU
        - CLAUDE_3_SONNET
        - DA_VINCI_003
        - CLAUDE_V_1
        - CLAUDE_INSTANT_V_1
        - DEEP_SEEK_R_1_DISTILL_LLAMA_70_B
        - CLAUDE_3_5_SONNET
    AIReasoningEffort:
      type: string
      enum:
        - off
        - adaptive
        - minimal
        - low
        - medium
        - high
      x-enumNames:
        - OFF
        - ADAPTIVE
        - MINIMAL
        - LOW
        - MEDIUM
        - HIGH
    AIParamsServiceTier:
      type: string
      enum:
        - default
        - flex
        - priority
      x-enumNames:
        - DEFAULT
        - FLEX
        - PRIORITY
  securitySchemes:
    token:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Voiceflow bearer token
````
