Skip to main content
POST
Continue a thread with a user message

Authorizations

Authorization
string
header
required

Use JWT token for authentication

Headers

devic-api-source
string

Free-text label recorded with the call, to tell apart the integrations that use the same key.

Path Parameters

threadId
string
required

The ID of the thread to continue

Body

application/json
message
required

The user message to append to the thread to continue it (string or object). Behaviour depends on the current thread state: a running/queued thread receives it on its next turn (after the pending tool response); a completed/failed/waiting thread is re-queued to run again with the message appended.

Example:

"Also include a summary of the previous steps"

Response

Message added to the thread

tokenUsage
object

Enhanced token usage with cost breakdown

metadata
object

Thread metadata containing prompt template parameters and tenant token

tenantId
string

Tenant ID for multi-tenant environments

Example:

"tenant-123"

isSubthread
boolean

Whether this thread is a subthread created by a parent handoff

Example:

false

parentThreadId
string

ID of the parent thread (if this is a subthread)

Example:

"64f5a5b8c123456789abcdef"

parentAgentId
string

ID of the parent agent (if this is a subthread)

Example:

"64f5a5b8c123456789abcdef"

subThreadToolCallId
string

Tool call ID in the parent thread that triggered this subthread

Example:

"call_abc123"

pendingHandOffSubThreadIds
string[]

IDs of subthreads still executing (for parent threads)

handOffSubThreadIds
string[]

All subthread IDs ever created during handoffs (for parent threads)

tasks
object[]

List of task for the thread execution

pendingAsyncToolCalls
object[]

Pending async tool calls awaiting an external response. Each entry exposes the callbackUrl the external system must POST the response to.

pausedReason
string

Reason the thread is paused (e.g. waiting for an async tool response).

pausedUntil
number

Epoch milliseconds when a paused thread is scheduled to resume. Only set while the thread is paused with a scheduled resume.

Example:

1721551200000

pausedTimestampMS
number

Epoch milliseconds when the thread was paused.

Example:

1721550000000

coreMemories
string[]

Audit trail of the core-memory blocks this thread saw: one snapshot (render revision + the injected entries as structured JSON) per distinct revision, including mid-run edits. Present only for agents with core memory enabled.

recalledMemories
string[]

Structured recall events of this thread: the automatic long-term-memory recall at run start plus every memory-tool lookup, each with the query and the facts/entities it surfaced. Present only for agents with long-term memory enabled.