{
  "specversion": "1.0",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "source": "https://platform.happyrobot.ai",
  "type": "session.status_changed",
  "time": "2025-07-08T12:34:56Z",
  "datacontenttype": "application/json",
  "data": {
    "schema_version": "2025-07-08",
    "org_id": "d96943ed-16de-4c71-9d3a-5619f80735b3",
    "run_id": "d96943ed-16de-4c71-9d3a-5619f80735b3",
    "session_id": "4ba9dfa9-9514-4cdc-b523-d621e0b74f0e",
    "use_case_id": "0195d9a8-2a6d-7755-ad1d-9880f30422da",
    "version_id": "82f4e1d2-c7fa-4ed0-9078-879a52eedd86",
    "status": {
      "previous": "in-progress",
      "current": "completed",
      "updated_at": "2025-07-08T12:34:56Z"
    },
    "org": {
      "name": "Circle logistics"
    },
    "use_case": {
      "name": "Inbound carrier sales",
      "version": "47"
    }
  }
}

When the status of a call session changes (e.g. in-progress → completed), HappyRobot emits this CloudEvents-formatted payload to the webhook URL you configured in your workspace settings.

​
Payload

​
specversion
string
required

CloudEvents spec version. Always 1.0.

​
id
string
required

Unique identifier for this event instance (UUID).

​
source
string
required

Event origin. Always https://platform.happyrobot.ai.

​
type
string
required

Event type. Always session.status_changed.

​
time
string
required

ISO 8601 timestamp when the event was emitted.

​
datacontenttype
string
required

Content type of the data payload. Always application/json.

​
data object

​
data.schema_version
string
required

Version of the data schema (YYYY-MM-DD).

​
data.org_id
string
required

Your organization’s UUID in HappyRobot.

​
data.run_id
string
required

Identifier of the overall run associated with this session.

​
data.session_id
string
required

Identifier of the call session whose status changed.

​
data.use_case_id
string
required

Identifier of the use-case definition triggering the session.

​
data.version_id
string
required

Identifier of the use-case version executed.

data.status sub-object
​
data.status.previous
string
required

Previous status.

​
data.status.current
string
required

Current status.

​
data.status.updated_at
string
required

ISO 8601 timestamp of the status change.

data.org sub-object
​
data.org.name
string
required

Human-readable organization name.

data.use_case sub-object
​
data.use_case.name
string
required

Name of the use case.

​
data.use_case.version
string
required

Version string of the use-case definition.

{
  "specversion": "1.0",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "source": "https://platform.happyrobot.ai",
  "type": "session.status_changed",
  "time": "2025-07-08T12:34:56Z",
  "datacontenttype": "application/json",
  "data": {
    "schema_version": "2025-07-08",
    "org_id": "d96943ed-16de-4c71-9d3a-5619f80735b3",
    "run_id": "d96943ed-16de-4c71-9d3a-5619f80735b3",
    "session_id": "4ba9dfa9-9514-4cdc-b523-d621e0b74f0e",
    "use_case_id": "0195d9a8-2a6d-7755-ad1d-9880f30422da",
    "version_id": "82f4e1d2-c7fa-4ed0-9078-879a52eedd86",
    "status": {
      "previous": "in-progress",
      "current": "completed",
      "updated_at": "2025-07-08T12:34:56Z"
    },
    "org": {
      "name": "Circle logistics"
    },
    "use_case": {
      "name": "Inbound carrier sales",
      "version": "47"
    }
  }
}