Sign in
Sessions

Get a message by ID

Returns a single message from the session by its ID. This feature is enabled for selected organizations only.

get/api/v0/sessions/{sessionId}/messages/{messageId}

Path parameters

sessionIdstring required

Session ID

messageIdstring required

Message ID

Query parameters

computerIdstring

Computer ID to query directly

Response

Response for status 200

idstring required
role'user' | 'assistant' | 'tool' | 'system' required
createdAtnumber required
updatedAtnumber required
parentIdstring
userMessageSource'web' | 'desktop' | 'cli_tui' | 'cli_exec' | 'cli_acp' | 'slack' | 'jira' | 'linear' | 'microsoft-teams' | 'sessions_api' | 'api' | 'sdk' | 'automation' | 'readiness-remediation' | 'readiness-evaluation' | 'wiki-generation' | 'wiki-ci-setup'
interactionMode'auto' | 'spec' | 'agi' | 'mission'
visibility'both' | 'llm_only' | 'user_only'
openaiMessageIdstring
openaiPhase'commentary' | 'final_answer' nullable
openaiEncryptedContentstring
openaiReasoningIdstring
openaiReasoningSummarystring
geminiThoughtSignaturestring

@deprecated Use thinking block signature fields with signatureProvider: "google" instead. Do not use in new code.

chatCompletionReasoningField'reasoning' | 'reasoning_content'
chatCompletionReasoningContentstring
isUserVisibleboolean
isErrorboolean
modelIdstring
apiProvider'bedrock' | 'anthropic' | 'vertex_anthropic' | 'bedrock_anthropic' | 'bedrock_converse' | 'bedrock_openai' | 'openai' | 'azure_openai' | 'google' | 'xai' | 'mistral' | 'fireworks' | 'baseten' | 'snowflake'
routerIdstring
reasoningEffort'none' | 'dynamic' | 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'
hookEventNamestring
hookMatcherstring
hookStatus'executing' | 'completed' | 'error'
hookToolCallIdstring
hookParentIdstring
hookOrdernumber
hookPreventedActionboolean
hiddenFromUserViewsboolean
hookStartTimenumber
hookEndTimenumber
isParallelExecutionboolean
parallelGroupIdstring

Changes

Changed in 6 of the 20 revisions of this API.38

  • 016bf58534e51See the full diff
    • ○

      added the optional property apiProvider to the response with the 200 status

      response-optional-property-added

  • 5ee8657e09324See the full diff
    • ○

      added the optional property content/items/anyOf[subschema #5]/scriptExecution to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property hookOrder to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property hookParentId to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property hookPreventedAction to the response with the 200 status

      response-optional-property-added

  • b702af89bbff1See the full diff
    • ●

      added the new sdk enum value to the userMessageSource response property for the response status 200

      response-property-enum-value-added

  • f31331a0620b2See the full diff
    • ○

      added subschema #2 subschema #6 to the content/items/ response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      removed subschema #2 subschema #6 from the content/items/ response property anyOf list for the response status 200

      response-property-any-of-removed

  • 0383294a98701See the full diff
    • ○

      added the optional property interactionMode to the response with the 200 status

      response-optional-property-added

  • 749e762366732See the full diff
    • ●

      added the new jira enum value to the userMessageSource response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new microsoft-teams enum value to the userMessageSource response property for the response status 200

      response-property-enum-value-added