/v1/workspace/heartbeat/actions/{id}/applyApply a heartbeat action
Say yes to one planned action and let it happen — today that means sending the follow-up it drafted on its conversation. 409 when the action is no longer in the planned state, or is a kind with nothing to apply. If the thread's contact changed between drafting and approval the approval becomes a REFUSAL carrying that reason rather than a message to the wrong person. An admin decides any draft; a rep decides a draft on their own lead, and anybody else's reads as a 404.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"conversation_id": 1,
"created_at": "2026-01-01T00:00:00Z",
"deferred_at": "2026-01-01T00:00:00Z",
"deferred_by_user_id": 1,
"deferred_until": "2026-01-01T00:00:00Z",
"id": 1,
"kind": "string",
"payload": "string",
"plan_index": 1,
"reason": "string",
"record_id": 1,
"reverted_at": "2026-01-01T00:00:00Z",
"reverted_by_user_id": 1,
"reverted_from": "string",
"reviewed_at": "2026-01-01T00:00:00Z",
"reviewed_by_user_id": 1,
"run_id": 1,
"settled_at": "2026-01-01T00:00:00Z",
"state": "string"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}