Sessions

Get a message by ID

Changed on

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}

Request

  • Base URL: https://api.factory.ai
  • URL: https://api.factory.ai/api/v0/sessions/{sessionId}/messages/{messageId}
  • Auth: HTTP bearer

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
seqinteger
userMessageSource'web' | 'desktop' | 'cli_tui' | 'cli_exec' | 'cli_acp' | 'slack' | 'jira' | 'linear' | 'microsoft-teams' | 'google-chat' | '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
geminiNativeContentstring
isUserVisibleboolean
isErrorboolean
modelIdstring
apiProvider'bedrock' | 'anthropic' | 'vertex_anthropic' | 'bedrock_anthropic' | 'bedrock_converse' | 'bedrock_openai' | 'openai' | 'azure_openai' | 'azure_anthropic' | 'google' | 'xai' | 'mistral' | 'fireworks' | 'baseten' | 'together' | 'snowflake' | 'databricks'
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

  • 447b966b4baaRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 030cbbf34315Revision changes
    • info

      added the optional property /// to the response with the status