AWawork-io
agentThreads

Lists agent thread messages.

Changed on

Lists messages from the specified personal-agent or custom-agent conversation, including the agent messages of the custom agents that the conversation started. 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.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

get/agents/threads/{threadId}/messages

Request

  • Base URL
    https://api.awork.com/api/v1
  • URL
    https://api.awork.com/api/v1/agents/threads/{threadId}/messages
  • Auth
    HTTP bearer

Path parameters

threadIdstring uuid required

The thread id.

Response

OK

idstring uuid

The id of the entity.

createdOnstring date-time

The date this entity was created.

createdBystring uuid

The id of the user who created this entity.

updatedOnstring date-time

The date this entity was last modified.

updatedBystring uuid

The id of the user who last modified this entity.

presetKeystring nullable

The live preset selected for this user message.

threadIdstring uuid

The thread that owns the message.

parentThreadIdstring uuid nullable

The parent thread for a delegated message.

rolestring nullable

The message author's role.

contentstring nullable

The user-visible message text.

clientMessageIdstring nullable

The client-generated idempotency key for a user message.

runtimeMessageIdstring nullable

The stable message reference used by the runtime provider.

modelstring nullable

The model that produced the message.

toolCallIdstring nullable

The provider tool-call identifier associated with the message.

agentIdstring uuid nullable

The custom agent that produced the message, if applicable.

messageOrderinteger

The message order.

isStreamingboolean

Whether the message is still streaming.

streamCompletedboolean

The stream completed.

traceIdstring nullable

The distributed trace that produced the message.

modelProviderstring nullable

The model provider selected for this message.

reasoningLevelstring nullable

The reasoning level selected for this message.

connectorIdsstring[] nullable

The connector identifiers selected for this message.

skillIdsstring[] nullable

The skill identifiers selected for this message.

Changes