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}

Get a message by ID

cURL

curl --request GET \
  --url https://api.factory.ai/api/v0/sessions/{sessionId}/messages/{messageId} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "content": [
    {
      "text": "<string>",
      "id": "<string>"
    }
  ],
  "createdAt": 123,
  "updatedAt": 123,
  "parentId": "<string>",
  "openaiMessageId": "<string>",
  "openaiEncryptedContent": "<string>",
  "openaiReasoningId": "<string>",
  "openaiReasoningSummary": "<string>",
  "geminiThoughtSignature": "<string>",
  "chatCompletionReasoningContent": "<string>",
  "isUserVisible": true,
  "isError": true
}

Authorizations

Authorization · string · header · required

Factory API key or JWT token for authentication

Path Parameters

sessionId · string · required

Session ID

messageId · string · required

Message ID

Query Parameters

computerId · string

Computer ID to query directly

Response

200

application/json

Response for status 200

id · string · required

role · enum<string> · required

Available options: user, assistant, tool, system

content · object[] · required

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Show child attributes

createdAt · number · required

updatedAt · number · required

parentId · string

userMessageSource · enum<string>

Available options: web, desktop, cli_tui, cli_exec, cli_acp, slack, linear, sessions_api, api, automation, readiness-remediation, readiness-evaluation, wiki-generation, wiki-ci-setup

visibility · enum<string>

Available options: both, llm_only, user_only

openaiMessageId · string

openaiPhase · enum<string> | null

Available options: commentary, final_answer

openaiEncryptedContent · string

openaiReasoningId · string

openaiReasoningSummary · string

geminiThoughtSignature · string

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

chatCompletionReasoningField · enum<string>

Available options: reasoning, reasoning_content

chatCompletionReasoningContent · string

isUserVisible · boolean

isError · boolean