Create Action

Use CreateAction to create a new Action. If action.id is empty, the service can assign one. Initial state defaults to ACTION_STATE_DRAFT unless the producer sets a different state.

Creation Guidance

Populate every field that applies at creation time. After creation, the action’s state and progress can change, but the content should not be rewritten.

Typical creation fields include:

  • scope and type to identify the category and agreed interpretation.

  • requested_by, assigned_to, and authorized_by for routing.

  • intent to describe purpose, method, and desired end state.

  • priority, timing windows, route, or area of operations where applicable.

  • object_links when Objects are targets, assets, or related context.

  • provenance.updated_at for source attribution.

Minimal Shape

{
  "action": {
    "name": "ISR Collection Alpha",
    "type": "isr_collection",
    "scope": "ACTION_SCOPE_TASK",
    "state": "ACTION_STATE_APPROVED",
    "priority": "ACTION_PRIORITY_HIGH",
    "assigned_to": {
      "id": "asset-uav-7",
      "type": "PRINCIPAL_TYPE_OBJECT"
    },
    "intent": {
      "purpose": "Observe NAI 3 before movement",
      "method": "Maintain collection orbit",
      "end_state": "Report activity changes"
    },
    "provenance": {
      "name": "ops-center",
      "updated_at": "2026-04-15T10:30:00Z"
    }
  }
}

After Creation

Use Update State for lifecycle transitions and progress. To change the substantive content, cancel the existing Action and create a replacement.