v1

latestOpenAPI 3.1.0MIT2026-08-0481194343.8 KB

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 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