Skip to navigation

Delete an instruction

View as MarkdownOpen in Claude

Deletes an instruction from its node and records the deletion in the node’s history. Use this operation to stop an instruction that has not run yet from being delivered, or to remove a repeatable instruction that must not run on later boots.

Requires: the simulation ACTIVE or INACTIVE, and the instruction not IN_PROGRESS; otherwise 400. Instructions that Air created (created_by_client is false) can be deleted only by an Air admin or SRE.

Caveat: deleting an instruction does not undo commands or file writes that already ran on the node.

Required scope: Simulation Edit (roles: Air Org Administrator, Air User)

Authentication

AuthorizationBearer

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

Path parameters

idstringRequiredformat: "uuid"
A UUID string identifying this instruction.

Response

No response body

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error