Lists agent thread messages.

GET

https://api.awork.com/api/v1/agents/threads/:threadId/messages

GET

/api/v1/agents/threads/:threadId/messages

curl https://api.awork.com/api/v1/agents/threads/threadId/messages \
     -H "Authorization: Bearer <token>"

[
  {
    "id": "23e68187-91d6-4f7e-8d31-e3f2c60d7427",
    "createdOn": "2022-03-11T15:33:47.100Z",
    "createdBy": "9ad63972-4396-4b0b-9e7d-40b852cdebf8",
    "updatedOn": "2022-03-11T21:15:00.100Z",
    "updatedBy": "3d844c62-7410-4df9-a5b2-78805c0ee260",
    "threadId": "6cbb219e-839d-4d23-b273-3a78bbd842ae",
    "parentThreadId": "b5a57e4d-0eec-45b6-b55e-4b70bf0f2a18",
    "role": "agent",
    "content": "The Acme website project is on track for Friday, with budget approval still pending.",
    "clientMessageId": "client-status-2026-08-29",
    "runtimeMessageId": "msg_01K4CLIENTSTATUS",
    "model": "gpt-5.6-terra",
    "toolCallId": "call_01K4CLIENTSTATUS",
    "temporaryFiles": [
      {
        "id": "temp_01K4CLIENTBRIEF",
        "name": "acme-client-brief.pdf",
        "mimeType": "application/pdf",
        "sandboxPath": "context/uploads/awork-9ad6397243964b0b9e7d40b852cdebf8-acme-client-brief.pdf",
        "downloadUrl": "/api/v1/agents/threads/6cbb219e-839d-4d23-b273-3a78bbd842ae/artifacts/download?path=client-status-report.pdf"
      }
    ],
    "toolCalls": [
      {
        "id": "call_01K4CLIENTSTATUS",
        "toolName": "code_mode_execute",
        "connectorId": "7e376777-7834-4af6-9eb8-da065f568d30",
        "connectionId": "af18602d-c8aa-4f63-a21e-5a7f59b2412c",
        "arguments": {},
        "response": "{\"status\":\"completed\"}"
      }
    ],
    "reasoning": [
      {
        "id": "reasoning_01J8M7Q2A3B4C5D6E7F8G9H0JK",
        "text": "Checked the project context before preparing the answer."
      }
    ],
    "agentId": "4d22e163-2b4a-4d47-b51c-5b2217f84f57",
    "messageOrder": 2,
    "isStreaming": false,
    "streamCompleted": true,
    "traceId": "0af7651916cd43dd8448eb211c80319c",
    "modelProvider": "openai",
    "reasoningLevel": "medium",
    "toolAccess": {
      "webSearchEnabled": true,
      "aworkAccessEnabled": true,
      "googleGenAiAccessEnabled": false,
      "openAiImageGenerationAccessEnabled": false
    },
    "connectorIds": [
      "string"
    ],
    "skillIds": [
      "string"
    ]
  }
]

Lists messages from the specified personal-agent or custom-agent conversation. Use this endpoint to retrieve replies after creating a thread or submitting a message. Returns not found if the thread is missing or the user cannot read it.

Required Permissions

Any authenticated user.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

threadIdstringRequiredformat: "uuid"

The thread id.

Response

idstringOptionalformat: "uuid"

The id of the entity.

createdOnstringOptionalformat: "date-time"

The date this entity was created.

createdBystringOptionalformat: "uuid"

The id of the user who created this entity.

updatedOnstringOptionalformat: "date-time"

The date this entity was last modified.

updatedBystringOptionalformat: "uuid"

The id of the user who last modified this entity.

threadIdstringOptionalformat: "uuid"

The thread that owns the message.

parentThreadIdstring or nullOptionalformat: "uuid"

The parent thread for a delegated message.

rolestring or nullOptional

The message author's role.

contentstring or nullOptional

The user-visible message text.

clientMessageIdstring or nullOptional

The client-generated idempotency key for a user message.

runtimeMessageIdstring or nullOptional

The stable message reference used by the runtime provider.

modelstring or nullOptional

The model that produced the message.

toolCallIdstring or nullOptional

The provider tool-call identifier associated with the message.

temporaryFileslist of objects or nullOptional

The temporary files attached to the message.

toolCallslist of objects or nullOptional

The tool calls stored with this message.

reasoninglist of objects or nullOptional

The user-visible reasoning text stored with this message.

agentIdstring or nullOptionalformat: "uuid"

The custom agent that produced the message, if applicable.

messageOrderintegerOptional

The message order.

isStreamingbooleanOptional

Whether the message is still streaming.

streamCompletedbooleanOptional

The stream completed.

traceIdstring or nullOptional

The distributed trace that produced the message.

modelProviderstring or nullOptional

The model provider selected for this message.

reasoningLevelstring or nullOptional

The reasoning level selected for this message.

toolAccessobjectOptional

Describes the tool access used for an agent message.

connectorIdslist of strings or nullOptional

The connector identifiers selected for this message.

skillIdslist of strings or nullOptional

The skill identifiers selected for this message.

Errors

404

Not Found Error