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

# Show queued message

> Show one queued message, including its terminal binding.

A queued message can dispatch and finish before you poll; the detail still
returns its bound ``messageId`` so you can read the reply. This is the durable
way to reconnect to a queued message before it has produced an assistant
message id.



## OpenAPI

````yaml https://api.summation.com/openapi.json get /v1/projects/{project_id}/conversations/{chat_id}/queue/{queued_message_id}
openapi: 3.1.0
info:
  title: summation-api public API
  version: 0.1.0
servers: []
security: []
tags:
  - name: Auth
    description: Machine authentication for API clients.
  - name: Tenant
    description: Organization and tenant context resolved by summation-api.
  - name: Projects
    description: Project resources.
  - name: Conversations
    description: Conversation and message resources.
  - name: Reports
    description: Report resources and report operations.
  - name: Runs
    description: Project run history and execution status.
  - name: Playbooks
    description: Playbook resources.
  - name: Files
    description: Project file resources.
  - name: Catalog Entries
    description: Project-scoped data asset attachments.
  - name: Data Connectors
    description: Reusable external data source connections.
  - name: App Connectors
    description: External app connectors whose tools the agent can use during chat.
  - name: Tables
    description: Canonical table metadata and catalog.
  - name: Views
    description: Canonical Summation view metadata and catalog.
  - name: Query Executions
    description: Read-only SQL query execution.
  - name: Grid
    description: Materialized grid status, sync, and lineage.
  - name: Schedules
    description: Schedule and schedule run inspection.
  - name: Workflows
    description: >-
      Workflows: what they run, when they run, and where their output is
      delivered.
  - name: Verification Tests
    description: >-
      Administrative custom verification-test definitions, overlays, and
      effective-set previews.
paths:
  /v1/projects/{project_id}/conversations/{chat_id}/queue/{queued_message_id}:
    get:
      tags:
        - Conversations
      summary: Show queued message
      description: >-
        Show one queued message, including its terminal binding.


        A queued message can dispatch and finish before you poll; the detail
        still

        returns its bound ``messageId`` so you can read the reply. This is the
        durable

        way to reconnect to a queued message before it has produced an assistant

        message id.
      operationId: show_queued_message
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            title: Project Id
        - name: chat_id
          in: path
          required: true
          schema:
            type: string
            title: Chat Id
        - name: queued_message_id
          in: path
          required: true
          schema:
            type: string
            title: Queued Message Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueuedMessageResponse'
        '400':
          description: Invalid request or unsupported option.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
        '401':
          description: Missing, invalid, or expired credentials.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
        '403':
          description: Authenticated but missing the required scope.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
        '404':
          description: Resource not found or not accessible.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: Rate limit exceeded.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
        '500':
          description: Internal server error.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemError'
      security:
        - SummationMachineAuth:
            - agent:read
components:
  schemas:
    QueuedMessageResponse:
      properties:
        data:
          $ref: '#/components/schemas/QueuedMessage'
      type: object
      required:
        - data
      title: QueuedMessageResponse
    ProblemError:
      description: >-
        Public error envelope (RFC 7807 ``application/problem+json``).


        Mirrors the body produced by :func:`api_error`. Declaring it in the
        contract

        lets generated clients type error handling instead of guessing.
      properties:
        type:
          description: URI reference identifying the problem type.
          title: Type
          type: string
        title:
          description: Short, human-readable summary of the problem type.
          title: Title
          type: string
        status:
          description: HTTP status code.
          title: Status
          type: integer
        detail:
          description: Human-readable explanation specific to this occurrence.
          title: Detail
          type: string
        code:
          description: Stable, machine-readable error code.
          title: Code
          type: string
        request_id:
          description: Correlation id, echoed in the x-request-id header.
          title: Request Id
          type: string
      required:
        - type
        - title
        - status
        - detail
        - code
        - request_id
      title: ProblemError
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    QueuedMessage:
      properties:
        id:
          type: string
          title: Id
          description: Queued message id (address it with the queue endpoints).
        position:
          type: integer
          title: Position
          description: >-
            1-based position among waiting messages (0 once dispatched or
            terminal).
        state:
          type: string
          title: State
          description: 'Lifecycle: queued, dispatching, dispatched, withdrawn, or failed.'
        message:
          type: string
          title: Message
          description: The user message text waiting to run.
        displayContent:
          anyOf:
            - type: string
            - type: 'null'
          title: Displaycontent
          description: Optional alternate display rendering of the message.
        model:
          anyOf:
            - type: string
            - type: 'null'
          title: Model
          description: Chat model id requested for the turn, if any.
        effort:
          anyOf:
            - type: string
            - type: 'null'
          title: Effort
          description: Reasoning effort requested for the turn, if any.
        createdAt:
          anyOf:
            - type: string
            - type: 'null'
          title: Createdat
          description: When the message was enqueued (ISO 8601).
        behindMessageId:
          anyOf:
            - type: string
            - type: 'null'
          title: Behindmessageid
          description: Assistant message id this turn waits behind, when known.
        createdByUserId:
          anyOf:
            - type: string
            - type: 'null'
          title: Createdbyuserid
          description: >-
            User who enqueued the message (shared conversations record the
            author).
        messageId:
          anyOf:
            - type: string
            - type: 'null'
          title: Messageid
          description: Bound assistant message id once the turn has dispatched (else null).
        userMessageId:
          anyOf:
            - type: string
            - type: 'null'
          title: Usermessageid
          description: Bound user message id once the turn has dispatched (else null).
        failureCode:
          anyOf:
            - type: string
            - type: 'null'
          title: Failurecode
          description: Stable failure code if the turn failed before running.
        failureDetail:
          anyOf:
            - type: string
            - type: 'null'
          title: Failuredetail
          description: Human-readable failure reason if the turn failed.
        held:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Held
          description: >-
            True while the conversation's queue is paused by a Stop; this
            message will not run until resumed.
        revision:
          anyOf:
            - type: integer
            - type: 'null'
          title: Revision
          description: >-
            The conversation's queue version when this was read; ignore
            snapshots older than one you hold.
      type: object
      required:
        - id
        - position
        - state
        - message
      title: QueuedMessage
    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
  securitySchemes:
    SummationMachineAuth:
      type: oauth2
      flows:
        clientCredentials:
          scopes:
            agent:read: agent:read
            agent:write: agent:write
          tokenUrl: /v1/auth/m2m/token

````