Command status changed

Sent each time the status of a command changes. Carries the full command.

WEBHOOK command.status_changed

Example

{
  "event_id": "evt_7b20e4",
  "type": "command.status_changed",
  "created_at": "2026-11-12T13:00:05Z",
  "data": {
    "command_id": "cmd_501",
    "battery_id": "bat_1",
    "action": "charge",
    "parameters": {
      "allow_import": true,
      "max_wh": 12000
    },
    "start": "2026-11-12T13:00:00Z",
    "end": "2026-11-12T15:00:00Z",
    "status": "active",
    "status_reason": null,
    "batch_id": null,
    "created_at": "2026-11-12T12:41:07Z",
    "updated_at": "2026-11-12T13:00:05Z"
  }
}

Authorizations

Authorization · string · header · required

OAuth 2.0 client credentials. Obtain a token from POST /token.

Body

application/json

event_id · string · required

Unique event identifier, for deduplication.

type · string · required

Allowed value: "command.status_changed"

created_at · string<date-time> · required

When Kapa created the event.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?Z$

Example:

"2026-11-12T18:00:00Z"

data · object · required

Show child attributes

Response

2XX

Event received. Any other response, or no response, causes a retry.