{
"id": "evt_xj2af4kr0x0hnbgpwy1zc7c1yc",
"object": "event",
"type": "session.terminated",
"api_version": "2026-10-15",
"livemode": true,
"account": null,
"sequence": 2,
"created_at": "2026-10-17T18:03:41Z",
"data": {
"object": {
"id": "ses_q8v1m3n7p4r6s9t0wxyhk5zba2",
"object": "session",
"livemode": true,
"status": "terminated",
"check": "chk_n7p4r6s9t0wxyhk5zba2q8v1m3",
"license": "lic_ba2q8v1m3n7p4r6s9t0wxyhk5z",
"talent": [
"tal_9t0wxyhk5zba2q8v1m3n7p4r6s"
],
"token": null,
"expires_at": null,
"renew_every": "PT60S",
"sampling": {
"audio_window_max": "PT15S",
"transcript": "every_turn"
},
"obligations": [
{
"type": "disclosure",
"level": "licensed",
"placement": "visible",
"text": "AI voice of Maya Okafor, licensed."
},
{
"type": "generation_instructions",
"instructions": [
"Do not discuss politics or religion.",
"Do not make promises on her behalf."
],
"term": "license:lic_ba2q8v1m3n7p4r6s9t0wxyhk5z/terms.voiceLineGrant.never"
},
{
"type": "usage_report",
"units": "seconds",
"within": "P1D"
}
],
"reasons": [],
"stream_url": "wss://app.reflections.ai/v1/sessions/ses_q8v1m3n7p4r6s9t0wxyhk5zba2/stream",
"termination": {
"reason": "license_revoked",
"sentence": "Maya Okafor revoked this license.",
"revocation": "rvk_s9t0wxyhk5zba2q8v1m3n7p4r6",
"sample": null,
"at": "2026-10-17T18:03:41Z"
},
"ended_at": null,
"metadata": {},
"created_at": "2026-10-17T18:00:00Z"
},
"previous_attributes": {
"status": "active",
"token": "eyJhbGciOiJFUzI1NiIsImtpZCI6InJmbC0yMDI2LTEwLWRvY3MzIiwidHlwIjoidGxwLXNlc3Npb24rand0In0.eyJhdWQiOiJhY2N0XzdwNHI2czl0MHd4eWhrNXpiYTJxOHYxbTNuIiwiZXhwIjoxNzkyMjYwMzAwLCJpYXQiOjE3OTIyNjAwMDAsImlzcyI6Imh0dHBzOi8vYXBwLnJlZmxlY3Rpb25zLmFpIiwianRpIjoic2VzX3E4djFtM243cDRyNnM5dDB3eHloazV6YmEyIiwic3ViIjoiYWNjdF83cDRyNnM5dDB3eHloazV6YmEycTh2MW0zbiIsInRscCI6eyJjaGVjayI6ImNoa19uN3A0cjZzOXQwd3h5aGs1emJhMnE4djFtMyIsImV1IjoiM2Y5YzFhN2U1YjJkOGY0MDYxYzNlOWE3YjVkMmY4MDE2ZTRjOWEzYjdkMWY1ZTJjOGE2YjRkMGY5ZTNjN2ExNSIsImZhY2V0cyI6WyJmY3RfdjFtM243cDRyNnM5dDB3eHloazV6YmEycTgiXSwibGljZW5zZXMiOlt7ImxpY2Vuc2UiOiJsaWNfYmEycTh2MW0zbjdwNHI2czl0MHd4eWhrNXoiLCJyZXZpc2lvbiI6Imxydl83cDRyNnM5dDB3eHloazV6YmEycTh2MW0zbiIsInRhbGVudCI6InRhbF85dDB3eHloazV6YmEycTh2MW0zbjdwNHI2cyIsInRlcm1zX2RpZ2VzdCI6InNoYTI1Njo4ZTBhMmM0ZTZiOGQwZjJhNGM2ZThiMGQyZjRhNmM4ZTBiMmQ0ZjZhOGMwZTJiNGQ2ZjhhMGMyZTRiNmQ4ZjBhIn1dLCJzYW1wbGluZyI6eyJhdWRpb193aW5kb3dfbWF4IjoiUFQxNVMiLCJ0cmFuc2NyaXB0IjoiZXZlcnlfdHVybiJ9LCJzZXNzaW9uIjoic2VzX3E4djFtM243cDRyNnM5dDB3eHloazV6YmEyIiwidGFsZW50IjpbInRhbF85dDB3eHloazV6YmEycTh2MW0zbjdwNHI2cyJdLCJ1c2UiOnsiY2hhbm5lbHMiOlsiaW5fYXBwIl0sImNvbW1lcmNpYWwiOmZhbHNlLCJraW5kIjoiaW1wZXJzb25hdGlvbiIsIm1vZGFsaXR5Ijoic3BlZWNoIiwicHVycG9zZSI6InBlcnNvbmFsIiwidGVycml0b3JpZXMiOlsiVVMiXX0sInZlciI6IjEuMCJ9fQ.RD_dRcXCqGHhYvg-PV3b1JIAoAX-WzVp02x6j-eSzmhYFxuZvniuJVrhJuHmzlFq_FYr6smqYXHQzb5p8DI0gA",
"expires_at": "2026-10-17T18:08:00Z",
"termination": null
}
}
}Webhooks
session.terminated
Reflections ended a live session.
WEBHOOK
session.terminated
{
"id": "evt_xj2af4kr0x0hnbgpwy1zc7c1yc",
"object": "event",
"type": "session.terminated",
"api_version": "2026-10-15",
"livemode": true,
"account": null,
"sequence": 2,
"created_at": "2026-10-17T18:03:41Z",
"data": {
"object": {
"id": "ses_q8v1m3n7p4r6s9t0wxyhk5zba2",
"object": "session",
"livemode": true,
"status": "terminated",
"check": "chk_n7p4r6s9t0wxyhk5zba2q8v1m3",
"license": "lic_ba2q8v1m3n7p4r6s9t0wxyhk5z",
"talent": [
"tal_9t0wxyhk5zba2q8v1m3n7p4r6s"
],
"token": null,
"expires_at": null,
"renew_every": "PT60S",
"sampling": {
"audio_window_max": "PT15S",
"transcript": "every_turn"
},
"obligations": [
{
"type": "disclosure",
"level": "licensed",
"placement": "visible",
"text": "AI voice of Maya Okafor, licensed."
},
{
"type": "generation_instructions",
"instructions": [
"Do not discuss politics or religion.",
"Do not make promises on her behalf."
],
"term": "license:lic_ba2q8v1m3n7p4r6s9t0wxyhk5z/terms.voiceLineGrant.never"
},
{
"type": "usage_report",
"units": "seconds",
"within": "P1D"
}
],
"reasons": [],
"stream_url": "wss://app.reflections.ai/v1/sessions/ses_q8v1m3n7p4r6s9t0wxyhk5zba2/stream",
"termination": {
"reason": "license_revoked",
"sentence": "Maya Okafor revoked this license.",
"revocation": "rvk_s9t0wxyhk5zba2q8v1m3n7p4r6",
"sample": null,
"at": "2026-10-17T18:03:41Z"
},
"ended_at": null,
"metadata": {},
"created_at": "2026-10-17T18:00:00Z"
},
"previous_attributes": {
"status": "active",
"token": "eyJhbGciOiJFUzI1NiIsImtpZCI6InJmbC0yMDI2LTEwLWRvY3MzIiwidHlwIjoidGxwLXNlc3Npb24rand0In0.eyJhdWQiOiJhY2N0XzdwNHI2czl0MHd4eWhrNXpiYTJxOHYxbTNuIiwiZXhwIjoxNzkyMjYwMzAwLCJpYXQiOjE3OTIyNjAwMDAsImlzcyI6Imh0dHBzOi8vYXBwLnJlZmxlY3Rpb25zLmFpIiwianRpIjoic2VzX3E4djFtM243cDRyNnM5dDB3eHloazV6YmEyIiwic3ViIjoiYWNjdF83cDRyNnM5dDB3eHloazV6YmEycTh2MW0zbiIsInRscCI6eyJjaGVjayI6ImNoa19uN3A0cjZzOXQwd3h5aGs1emJhMnE4djFtMyIsImV1IjoiM2Y5YzFhN2U1YjJkOGY0MDYxYzNlOWE3YjVkMmY4MDE2ZTRjOWEzYjdkMWY1ZTJjOGE2YjRkMGY5ZTNjN2ExNSIsImZhY2V0cyI6WyJmY3RfdjFtM243cDRyNnM5dDB3eHloazV6YmEycTgiXSwibGljZW5zZXMiOlt7ImxpY2Vuc2UiOiJsaWNfYmEycTh2MW0zbjdwNHI2czl0MHd4eWhrNXoiLCJyZXZpc2lvbiI6Imxydl83cDRyNnM5dDB3eHloazV6YmEycTh2MW0zbiIsInRhbGVudCI6InRhbF85dDB3eHloazV6YmEycTh2MW0zbjdwNHI2cyIsInRlcm1zX2RpZ2VzdCI6InNoYTI1Njo4ZTBhMmM0ZTZiOGQwZjJhNGM2ZThiMGQyZjRhNmM4ZTBiMmQ0ZjZhOGMwZTJiNGQ2ZjhhMGMyZTRiNmQ4ZjBhIn1dLCJzYW1wbGluZyI6eyJhdWRpb193aW5kb3dfbWF4IjoiUFQxNVMiLCJ0cmFuc2NyaXB0IjoiZXZlcnlfdHVybiJ9LCJzZXNzaW9uIjoic2VzX3E4djFtM243cDRyNnM5dDB3eHloazV6YmEyIiwidGFsZW50IjpbInRhbF85dDB3eHloazV6YmEycTh2MW0zbjdwNHI2cyJdLCJ1c2UiOnsiY2hhbm5lbHMiOlsiaW5fYXBwIl0sImNvbW1lcmNpYWwiOmZhbHNlLCJraW5kIjoiaW1wZXJzb25hdGlvbiIsIm1vZGFsaXR5Ijoic3BlZWNoIiwicHVycG9zZSI6InBlcnNvbmFsIiwidGVycml0b3JpZXMiOlsiVVMiXX0sInZlciI6IjEuMCJ9fQ.RD_dRcXCqGHhYvg-PV3b1JIAoAX-WzVp02x6j-eSzmhYFxuZvniuJVrhJuHmzlFq_FYr6smqYXHQzb5p8DI0gA",
"expires_at": "2026-10-17T18:08:00Z",
"termination": null
}
}
}Planned protocol reference. The current Talent API sandbox does not register webhook endpoints
or deliver events. Use polling and the test escalation helper for supported sandbox
transitions.
Start with the runnable quickstart and sandbox support matrix.
What to do
- Stop output within one second. The same message arrives on the session stream, usually first.
- Do not renew; renewal fails with
session_not_active. - Report the session’s usage up to
termination.at.
2xx within 10 seconds, then do the work. Deliveries can repeat; ignore an event ID you have processed.
Related
Real-time sessions
Session stream
Authorizations
Your secret key, rk_test_… or rk_live_…, sent as Authorization: Bearer <key>. Keep it
on your server. Restricted keys carry only the scopes you give them.
Headers
The event ID. Use it to ignore duplicate deliveries.
Unix seconds when this delivery was signed. Reject deliveries more than 5 minutes old.
Space-separated v1,<base64> signatures: HMAC-SHA256 with your endpoint secret over
<webhook-id>.<webhook-timestamp>.<body>. More than one appears while a secret rotates.
Body
application/json
Equal to the webhook-id header.
Pattern:
^evt_[0-9a-hjkmnp-tv-z]{26}$Always event.
Allowed value:
"event"Always session.terminated.
Available options:
session.terminated The API version data.object is rendered in.
true for live events, false for test events.
Increases by one with each event about the same object. Ignore an event whose sequence is lower than one you have processed.
When the event happened.
The session in object, and the fields that changed in previous_attributes.
Show child attributes
Show child attributes
The connected licensee the event concerns, when it is not your own account.
Pattern:
^acct_[0-9a-hjkmnp-tv-z]{26}$Response
200
Return any 2xx status within 10 seconds. Anything else is retried.