Skip to main content
POST

Authorizations

Authorization
string
header
required

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

Path Parameters

workspaceId
string
required
Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

objectiveId
string
required

The ID of the objective. If you have assigned an external ID to the objective, you can prefix the ID with "external_id:". For example, "external_id:1234567890". Otherwise, the ID assigned by Cadenya should be used.

Example:

"obj_01HXKD2E5NQM3T9AYWCFQAZGFV"

Body

application/json
message
string
required

The user message to send to the objective.

enqueue
boolean

When false, the objective must be waiting and the message is sent immediately. When true, a waiting objective still receives the message immediately; an objective whose agent loop is busy queues it instead, and the agent picks it up before its next assistant turn. Queued messages can be listed and removed until then.

Response

OK

ContinueObjectiveResponse reports whether the message joined the conversation immediately or was queued for the agent loop.

type
enum<string>
required
Available options:
event
event
object
required

The user message event, when the objective was waiting and the message was sent immediately.