Update Action State

Use UpdateActionState to advance an Action through its lifecycle or to report execution progress. This is the primary way to modify an Action after creation.

Lifecycle Flow

The normal state flow is:

DRAFT -> PENDING -> APPROVED -> ASSIGNED -> ACKNOWLEDGED
  -> PLANNED -> IN_PROGRESS -> COMPLETED

Terminal states are final:

  • ACTION_STATE_COMPLETED

  • ACTION_STATE_FAILED

  • ACTION_STATE_CANCELLED

  • ACTION_STATE_REJECTED

Set ACTION_STATE_CANCELLED to cancel an Action. There is no separate delete operation for Actions.

Progress Updates

Same-state updates are valid. For example, an Action can remain ACTION_STATE_IN_PROGRESS while its progress.phase changes from ON_STATION to COLLECTING to RTB.

{
  "state": "ACTION_STATE_IN_PROGRESS",
  "progress": {
    "phase": "ON_STATION",
    "status_message": "Asset on station, commencing collection orbit"
  },
  "provenance": {
    "name": "execution-agent",
    "updated_at": "2026-04-15T10:35:00Z"
  }
}

Scope

UpdateActionState changes state, progress, and optional provenance. It does not rewrite the original Action content, routing, approval chain, or other substructure.