Skip to main content
GET
Read one thread and its messages
Read the thread’s messages and status before sending a typed continuation through Act. Payment and authentication responses must reference the exact pending request.

Authorizations

x-api-key
string
header
required

Path Parameters

threadId
string
required

Query Parameters

actingAgentId
string
cursor
string
limit
integer
Required range: 1 <= x <= 100

Response

Durable thread state and paginated messages

thread
string
required
Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
messages
object[]
required
Maximum array length: 100
actions
object[]
required
requests
object[]
required
cursor
string
required
Required string length: 3 - 200
Pattern: ^.+:(0|[1-9][0-9]*)$
hasMore
boolean
required
archived
boolean
required
needsAttention
boolean
required
errors
object[]

Error events in this page. Retryable does not authorize replaying an accepted effect or payment.

Maximum array length: 100
Last modified on October 8, 2026