COcoasty
machines

Acknowledge an external-machine command

DEVICE TOKEN ONLY. Submit a terminal success/failure using the exact fencing_token and precondition_frame_id from the command. The optional observation atomically supplies the post-action frame. An identical result replay returns replayed=true; a different body for a completed command, a frame-precondition mismatch, an expired command, or a stale fencing token returns 409 and is never re-executed.

post/v1/machines/{machine_id}/commands/{command_id}/results

Request

Request body

fencing_tokeninteger required
precondition_frame_idstring uuid nullable required

Must exactly echo the command envelope's precondition_frame_id, including null. A mismatch is 409 FRAME_PRECONDITION_MISMATCH.

successboolean required
resultobject nullable
errorstring nullable

Response

Command result accepted or safely replayed.

machine_idstring required
command_idstring uuid required
status'completed' | 'failed' required
replayedboolean required

true for a byte-equivalent result replay; a conflicting result returns 409.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.