---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/events/event-types/taskrouter/workflow#article
headline: Workflow
description: List of TaskRouter event types regarding Workflow available in Twilio Event Streams, as well as their JSON schemas and examples.
url: https://www.twilio.com/docs/events/event-types/taskrouter/workflow
inLanguage: en
dateModified: 2026-10-12T19:18:47.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Workflow

## Entered

`com.twilio.taskrouter.workflow.entered`

> \[!NOTE]
>
> The `worker_time_in_previous_activity` field began reporting in seconds starting May 21, 2021. Version 2 of the TaskRouter schema added a new `worker_time_in_previous_activity_ms` field that was not exposed through Event Streams previously. If you want to measure this field in milliseconds, you must use schema version 2.

Workflow Entered events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/taskrouter/api/event).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.taskrouter.workflow.entered",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TaskRouter.WDSEvent/4",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "EV0000000000000000000000000000001",
    "name" : "ReservationCreated",
    "account_sid" : "AC0000000000000000000000000000001",
    "account_friendly_name" : "An account name",
    "parent_account_sid" : "AC0000000000000000000000000000001",
    "parent_friendly_name" : "Another account name",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "level" : "INFO",
    "group" : "reservation",
    "product_name" : "TaskRouter",
    "publisher" : "Flex Task Assignment",
    "publisher_metadata" : "{}",
    "payload_type" : "application/json",
    "payload" : {
      "sid" : "EV0000000000000000000000000000001",
      "eventtype" : "reservation.created",
      "account_sid" : "AC0000000000000000000000000000001",
      "timestamp" : "2025-01-01T00:00:00.000Z",
      "workspace_sid" : "WS0000000000000000000000000000001",
      "workspace_name" : "Flex Task Assignment",
      "task_sid" : "WT0000000000000000000000000000001",
      "task_attributes" : "{}",
      "task_age" : 31088,
      "task_date_created" : "2025-01-01T00:00:00.000Z",
      "task_priority" : 1,
      "task_assignment_status" : "reserved",
      "task_completed_reason" : "All reservations were completed",
      "task_canceled_reason" : "hangup",
      "reason" : "hangup",
      "task_channel_sid" : "TC0000000000000000000000000000001",
      "task_channel_unique_name" : "chat",
      "reservation_sid" : "WR0000000000000000000000000000001",
      "worker_sid" : "WK0000000000000000000000000000001",
      "worker_name" : "Flex Task Assignment",
      "worker_attributes" : "{}",
      "worker_activity_sid" : "WA0000000000000000000000000000001",
      "worker_activity_name" : "handling 2",
      "worker_time_in_previous_activity" : 322,
      "worker_time_in_previous_activity_ms" : 322859,
      "worker_previous_activity_sid" : "WA0000000000000000000000000000002",
      "worker_previous_activity_name" : "handling 1",
      "workflow_sid" : "WW0000000000000000000000000000002",
      "workflow_name" : "My workflow",
      "task_queue_sid" : "WQ0000000000000000000000000000002",
      "task_queue_name" : "My task queue",
      "worker_channel_available" : 1,
      "worker_channel_capacity" : 1,
      "worker_channel_available_capacity" : 100.0,
      "worker_channel_previous_capacity" : 6.0,
      "worker_channel_task_count" : 0,
      "workflow_filter_name" : "My workflow filter name",
      "workflow_filter_expression" : "1==1",
      "workflow_filter_target_expression" : "worker.channel.chat.assigned_tasks <= 1",
      "workflow_filter_target_name" : "My workflow filter target name",
      "previous_task_queue_sid" : "WQ0000000000000000000000000000001",
      "previous_task_queue_name" : "My previous task queue name",
      "previous_task_priority" : 3,
      "target_changed_reason" : "skipped",
      "task_re_evaluated_reason" : "reservation_timeout",
      "task_queue_target_expression" : "allowed_channels HAS \"chat\"",
      "task_transfer_sid" : "TT0000000000000000000000000000001",
      "transfer_type" : "QUEUE",
      "transfer_initiating_worker_sid" : "WK0000000000000000000000000000001",
      "transfer_initiating_reservation_sid" : "WR0000000000000000000000000000001",
      "transfer_to" : "WQ0000000000000000000000000000001",
      "transfer_mode" : "COLD",
      "transfer_started" : "2025-01-01T00:00:00.000Z",
      "transfer_failed_reason" : "",
      "transfer_status" : "complete",
      "event_description" : "Reservation WR0000000000000000000000000000001 created",
      "resource_type" : "reservation",
      "resource_sid" : "WR0000000000000000000000000000001",
      "task_routing_target" : "WK0000000000000000000000000000001",
      "reservation_reason_code" : 45302,
      "task_age_in_queue" : 31086,
      "task_queue_entered_date" : "2025-01-01T00:00:00.000Z",
      "task_version" : 4,
      "reservation_version" : 0,
      "task_virtual_start_time" : "2025-01-01T00:00:00.000Z",
      "worker_channel_consumed_capacity" : 2,
      "worker_version" : 4019,
      "task_channel_name" : "My task channel name",
      "task_channel_optimized_routing" : false,
      "known_worker_sid" : "WK0000000000000000000000000000001",
      "activity_sid" : "WA0000000000000000000000000000001",
      "activity_name" : "My activity name",
      "activity_available" : true,
      "operating_unit_sid" : "OU0000000000000000000000000000001",
      "operating_unit_friendly_name" : "My operating unit",
      "operating_unit_date_created" : "2025-01-01T00:00:00.000Z",
      "operating_unit_date_updated" : "2025-01-01T00:00:00.000Z",
      "task_add_on_attributes" : "{}",
      "task_timeout" : 86400,
      "worker_available" : true,
      "reservation_timeout" : 25,
      "reservation_status" : "accepted"
    }
  }
}
```

**Versions**

* [v4 (latest)](https://events-schemas.twilio.com/TaskRouter.WDSEvent/4)
* [v3](https://events-schemas.twilio.com/TaskRouter.WDSEvent/3)
* [v2](https://events-schemas.twilio.com/TaskRouter.WDSEvent/2)
* [v1](https://events-schemas.twilio.com/TaskRouter.WDSEvent/1)

## Rejected

`com.twilio.taskrouter.workflow.rejected`

> \[!NOTE]
>
> The `worker_time_in_previous_activity` field began reporting in seconds starting May 21, 2021. Version 2 of the TaskRouter schema added a new `worker_time_in_previous_activity_ms` field that was not exposed through Event Streams previously. If you want to measure this field in milliseconds, you must use schema version 2.

Workflow Rejected events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/taskrouter/api/event).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.taskrouter.workflow.rejected",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TaskRouter.WDSEvent/4",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "EV0000000000000000000000000000001",
    "name" : "ReservationCreated",
    "account_sid" : "AC0000000000000000000000000000001",
    "account_friendly_name" : "An account name",
    "parent_account_sid" : "AC0000000000000000000000000000001",
    "parent_friendly_name" : "Another account name",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "level" : "INFO",
    "group" : "reservation",
    "product_name" : "TaskRouter",
    "publisher" : "Flex Task Assignment",
    "publisher_metadata" : "{}",
    "payload_type" : "application/json",
    "payload" : {
      "sid" : "EV0000000000000000000000000000001",
      "eventtype" : "reservation.created",
      "account_sid" : "AC0000000000000000000000000000001",
      "timestamp" : "2025-01-01T00:00:00.000Z",
      "workspace_sid" : "WS0000000000000000000000000000001",
      "workspace_name" : "Flex Task Assignment",
      "task_sid" : "WT0000000000000000000000000000001",
      "task_attributes" : "{}",
      "task_age" : 31088,
      "task_date_created" : "2025-01-01T00:00:00.000Z",
      "task_priority" : 1,
      "task_assignment_status" : "reserved",
      "task_completed_reason" : "All reservations were completed",
      "task_canceled_reason" : "hangup",
      "reason" : "hangup",
      "task_channel_sid" : "TC0000000000000000000000000000001",
      "task_channel_unique_name" : "chat",
      "reservation_sid" : "WR0000000000000000000000000000001",
      "worker_sid" : "WK0000000000000000000000000000001",
      "worker_name" : "Flex Task Assignment",
      "worker_attributes" : "{}",
      "worker_activity_sid" : "WA0000000000000000000000000000001",
      "worker_activity_name" : "handling 2",
      "worker_time_in_previous_activity" : 322,
      "worker_time_in_previous_activity_ms" : 322859,
      "worker_previous_activity_sid" : "WA0000000000000000000000000000002",
      "worker_previous_activity_name" : "handling 1",
      "workflow_sid" : "WW0000000000000000000000000000002",
      "workflow_name" : "My workflow",
      "task_queue_sid" : "WQ0000000000000000000000000000002",
      "task_queue_name" : "My task queue",
      "worker_channel_available" : 1,
      "worker_channel_capacity" : 1,
      "worker_channel_available_capacity" : 100.0,
      "worker_channel_previous_capacity" : 6.0,
      "worker_channel_task_count" : 0,
      "workflow_filter_name" : "My workflow filter name",
      "workflow_filter_expression" : "1==1",
      "workflow_filter_target_expression" : "worker.channel.chat.assigned_tasks <= 1",
      "workflow_filter_target_name" : "My workflow filter target name",
      "previous_task_queue_sid" : "WQ0000000000000000000000000000001",
      "previous_task_queue_name" : "My previous task queue name",
      "previous_task_priority" : 3,
      "target_changed_reason" : "skipped",
      "task_re_evaluated_reason" : "reservation_timeout",
      "task_queue_target_expression" : "allowed_channels HAS \"chat\"",
      "task_transfer_sid" : "TT0000000000000000000000000000001",
      "transfer_type" : "QUEUE",
      "transfer_initiating_worker_sid" : "WK0000000000000000000000000000001",
      "transfer_initiating_reservation_sid" : "WR0000000000000000000000000000001",
      "transfer_to" : "WQ0000000000000000000000000000001",
      "transfer_mode" : "COLD",
      "transfer_started" : "2025-01-01T00:00:00.000Z",
      "transfer_failed_reason" : "",
      "transfer_status" : "complete",
      "event_description" : "Reservation WR0000000000000000000000000000001 created",
      "resource_type" : "reservation",
      "resource_sid" : "WR0000000000000000000000000000001",
      "task_routing_target" : "WK0000000000000000000000000000001",
      "reservation_reason_code" : 45302,
      "task_age_in_queue" : 31086,
      "task_queue_entered_date" : "2025-01-01T00:00:00.000Z",
      "task_version" : 4,
      "reservation_version" : 0,
      "task_virtual_start_time" : "2025-01-01T00:00:00.000Z",
      "worker_channel_consumed_capacity" : 2,
      "worker_version" : 4019,
      "task_channel_name" : "My task channel name",
      "task_channel_optimized_routing" : false,
      "known_worker_sid" : "WK0000000000000000000000000000001",
      "activity_sid" : "WA0000000000000000000000000000001",
      "activity_name" : "My activity name",
      "activity_available" : true,
      "operating_unit_sid" : "OU0000000000000000000000000000001",
      "operating_unit_friendly_name" : "My operating unit",
      "operating_unit_date_created" : "2025-01-01T00:00:00.000Z",
      "operating_unit_date_updated" : "2025-01-01T00:00:00.000Z",
      "task_add_on_attributes" : "{}",
      "task_timeout" : 86400,
      "worker_available" : true,
      "reservation_timeout" : 25,
      "reservation_status" : "accepted"
    }
  }
}
```

**Versions**

* [v4 (latest)](https://events-schemas.twilio.com/TaskRouter.WDSEvent/4)
* [v3](https://events-schemas.twilio.com/TaskRouter.WDSEvent/3)
* [v2](https://events-schemas.twilio.com/TaskRouter.WDSEvent/2)
* [v1](https://events-schemas.twilio.com/TaskRouter.WDSEvent/1)

## Skipped

`com.twilio.taskrouter.workflow.skipped`

> \[!NOTE]
>
> The `worker_time_in_previous_activity` field began reporting in seconds starting May 21, 2021. Version 2 of the TaskRouter schema added a new `worker_time_in_previous_activity_ms` field that was not exposed through Event Streams previously. If you want to measure this field in milliseconds, you must use schema version 2.

Workflow Skipped events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/taskrouter/api/event).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.taskrouter.workflow.skipped",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TaskRouter.WDSEvent/4",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "EV0000000000000000000000000000001",
    "name" : "ReservationCreated",
    "account_sid" : "AC0000000000000000000000000000001",
    "account_friendly_name" : "An account name",
    "parent_account_sid" : "AC0000000000000000000000000000001",
    "parent_friendly_name" : "Another account name",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "level" : "INFO",
    "group" : "reservation",
    "product_name" : "TaskRouter",
    "publisher" : "Flex Task Assignment",
    "publisher_metadata" : "{}",
    "payload_type" : "application/json",
    "payload" : {
      "sid" : "EV0000000000000000000000000000001",
      "eventtype" : "reservation.created",
      "account_sid" : "AC0000000000000000000000000000001",
      "timestamp" : "2025-01-01T00:00:00.000Z",
      "workspace_sid" : "WS0000000000000000000000000000001",
      "workspace_name" : "Flex Task Assignment",
      "task_sid" : "WT0000000000000000000000000000001",
      "task_attributes" : "{}",
      "task_age" : 31088,
      "task_date_created" : "2025-01-01T00:00:00.000Z",
      "task_priority" : 1,
      "task_assignment_status" : "reserved",
      "task_completed_reason" : "All reservations were completed",
      "task_canceled_reason" : "hangup",
      "reason" : "hangup",
      "task_channel_sid" : "TC0000000000000000000000000000001",
      "task_channel_unique_name" : "chat",
      "reservation_sid" : "WR0000000000000000000000000000001",
      "worker_sid" : "WK0000000000000000000000000000001",
      "worker_name" : "Flex Task Assignment",
      "worker_attributes" : "{}",
      "worker_activity_sid" : "WA0000000000000000000000000000001",
      "worker_activity_name" : "handling 2",
      "worker_time_in_previous_activity" : 322,
      "worker_time_in_previous_activity_ms" : 322859,
      "worker_previous_activity_sid" : "WA0000000000000000000000000000002",
      "worker_previous_activity_name" : "handling 1",
      "workflow_sid" : "WW0000000000000000000000000000002",
      "workflow_name" : "My workflow",
      "task_queue_sid" : "WQ0000000000000000000000000000002",
      "task_queue_name" : "My task queue",
      "worker_channel_available" : 1,
      "worker_channel_capacity" : 1,
      "worker_channel_available_capacity" : 100.0,
      "worker_channel_previous_capacity" : 6.0,
      "worker_channel_task_count" : 0,
      "workflow_filter_name" : "My workflow filter name",
      "workflow_filter_expression" : "1==1",
      "workflow_filter_target_expression" : "worker.channel.chat.assigned_tasks <= 1",
      "workflow_filter_target_name" : "My workflow filter target name",
      "previous_task_queue_sid" : "WQ0000000000000000000000000000001",
      "previous_task_queue_name" : "My previous task queue name",
      "previous_task_priority" : 3,
      "target_changed_reason" : "skipped",
      "task_re_evaluated_reason" : "reservation_timeout",
      "task_queue_target_expression" : "allowed_channels HAS \"chat\"",
      "task_transfer_sid" : "TT0000000000000000000000000000001",
      "transfer_type" : "QUEUE",
      "transfer_initiating_worker_sid" : "WK0000000000000000000000000000001",
      "transfer_initiating_reservation_sid" : "WR0000000000000000000000000000001",
      "transfer_to" : "WQ0000000000000000000000000000001",
      "transfer_mode" : "COLD",
      "transfer_started" : "2025-01-01T00:00:00.000Z",
      "transfer_failed_reason" : "",
      "transfer_status" : "complete",
      "event_description" : "Reservation WR0000000000000000000000000000001 created",
      "resource_type" : "reservation",
      "resource_sid" : "WR0000000000000000000000000000001",
      "task_routing_target" : "WK0000000000000000000000000000001",
      "reservation_reason_code" : 45302,
      "task_age_in_queue" : 31086,
      "task_queue_entered_date" : "2025-01-01T00:00:00.000Z",
      "task_version" : 4,
      "reservation_version" : 0,
      "task_virtual_start_time" : "2025-01-01T00:00:00.000Z",
      "worker_channel_consumed_capacity" : 2,
      "worker_version" : 4019,
      "task_channel_name" : "My task channel name",
      "task_channel_optimized_routing" : false,
      "known_worker_sid" : "WK0000000000000000000000000000001",
      "activity_sid" : "WA0000000000000000000000000000001",
      "activity_name" : "My activity name",
      "activity_available" : true,
      "operating_unit_sid" : "OU0000000000000000000000000000001",
      "operating_unit_friendly_name" : "My operating unit",
      "operating_unit_date_created" : "2025-01-01T00:00:00.000Z",
      "operating_unit_date_updated" : "2025-01-01T00:00:00.000Z",
      "task_add_on_attributes" : "{}",
      "task_timeout" : 86400,
      "worker_available" : true,
      "reservation_timeout" : 25,
      "reservation_status" : "accepted"
    }
  }
}
```

**Versions**

* [v4 (latest)](https://events-schemas.twilio.com/TaskRouter.WDSEvent/4)
* [v3](https://events-schemas.twilio.com/TaskRouter.WDSEvent/3)
* [v2](https://events-schemas.twilio.com/TaskRouter.WDSEvent/2)
* [v1](https://events-schemas.twilio.com/TaskRouter.WDSEvent/1)

## Target Matched

`com.twilio.taskrouter.workflow.target-matched`

> \[!NOTE]
>
> The `worker_time_in_previous_activity` field began reporting in seconds starting May 21, 2021. Version 2 of the TaskRouter schema added a new `worker_time_in_previous_activity_ms` field that was not exposed through Event Streams previously. If you want to measure this field in milliseconds, you must use schema version 2.

Workflow Target Matched events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/taskrouter/api/event).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.taskrouter.workflow.target-matched",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TaskRouter.WDSEvent/4",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "EV0000000000000000000000000000001",
    "name" : "ReservationCreated",
    "account_sid" : "AC0000000000000000000000000000001",
    "account_friendly_name" : "An account name",
    "parent_account_sid" : "AC0000000000000000000000000000001",
    "parent_friendly_name" : "Another account name",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "level" : "INFO",
    "group" : "reservation",
    "product_name" : "TaskRouter",
    "publisher" : "Flex Task Assignment",
    "publisher_metadata" : "{}",
    "payload_type" : "application/json",
    "payload" : {
      "sid" : "EV0000000000000000000000000000001",
      "eventtype" : "reservation.created",
      "account_sid" : "AC0000000000000000000000000000001",
      "timestamp" : "2025-01-01T00:00:00.000Z",
      "workspace_sid" : "WS0000000000000000000000000000001",
      "workspace_name" : "Flex Task Assignment",
      "task_sid" : "WT0000000000000000000000000000001",
      "task_attributes" : "{}",
      "task_age" : 31088,
      "task_date_created" : "2025-01-01T00:00:00.000Z",
      "task_priority" : 1,
      "task_assignment_status" : "reserved",
      "task_completed_reason" : "All reservations were completed",
      "task_canceled_reason" : "hangup",
      "reason" : "hangup",
      "task_channel_sid" : "TC0000000000000000000000000000001",
      "task_channel_unique_name" : "chat",
      "reservation_sid" : "WR0000000000000000000000000000001",
      "worker_sid" : "WK0000000000000000000000000000001",
      "worker_name" : "Flex Task Assignment",
      "worker_attributes" : "{}",
      "worker_activity_sid" : "WA0000000000000000000000000000001",
      "worker_activity_name" : "handling 2",
      "worker_time_in_previous_activity" : 322,
      "worker_time_in_previous_activity_ms" : 322859,
      "worker_previous_activity_sid" : "WA0000000000000000000000000000002",
      "worker_previous_activity_name" : "handling 1",
      "workflow_sid" : "WW0000000000000000000000000000002",
      "workflow_name" : "My workflow",
      "task_queue_sid" : "WQ0000000000000000000000000000002",
      "task_queue_name" : "My task queue",
      "worker_channel_available" : 1,
      "worker_channel_capacity" : 1,
      "worker_channel_available_capacity" : 100.0,
      "worker_channel_previous_capacity" : 6.0,
      "worker_channel_task_count" : 0,
      "workflow_filter_name" : "My workflow filter name",
      "workflow_filter_expression" : "1==1",
      "workflow_filter_target_expression" : "worker.channel.chat.assigned_tasks <= 1",
      "workflow_filter_target_name" : "My workflow filter target name",
      "previous_task_queue_sid" : "WQ0000000000000000000000000000001",
      "previous_task_queue_name" : "My previous task queue name",
      "previous_task_priority" : 3,
      "target_changed_reason" : "skipped",
      "task_re_evaluated_reason" : "reservation_timeout",
      "task_queue_target_expression" : "allowed_channels HAS \"chat\"",
      "task_transfer_sid" : "TT0000000000000000000000000000001",
      "transfer_type" : "QUEUE",
      "transfer_initiating_worker_sid" : "WK0000000000000000000000000000001",
      "transfer_initiating_reservation_sid" : "WR0000000000000000000000000000001",
      "transfer_to" : "WQ0000000000000000000000000000001",
      "transfer_mode" : "COLD",
      "transfer_started" : "2025-01-01T00:00:00.000Z",
      "transfer_failed_reason" : "",
      "transfer_status" : "complete",
      "event_description" : "Reservation WR0000000000000000000000000000001 created",
      "resource_type" : "reservation",
      "resource_sid" : "WR0000000000000000000000000000001",
      "task_routing_target" : "WK0000000000000000000000000000001",
      "reservation_reason_code" : 45302,
      "task_age_in_queue" : 31086,
      "task_queue_entered_date" : "2025-01-01T00:00:00.000Z",
      "task_version" : 4,
      "reservation_version" : 0,
      "task_virtual_start_time" : "2025-01-01T00:00:00.000Z",
      "worker_channel_consumed_capacity" : 2,
      "worker_version" : 4019,
      "task_channel_name" : "My task channel name",
      "task_channel_optimized_routing" : false,
      "known_worker_sid" : "WK0000000000000000000000000000001",
      "activity_sid" : "WA0000000000000000000000000000001",
      "activity_name" : "My activity name",
      "activity_available" : true,
      "operating_unit_sid" : "OU0000000000000000000000000000001",
      "operating_unit_friendly_name" : "My operating unit",
      "operating_unit_date_created" : "2025-01-01T00:00:00.000Z",
      "operating_unit_date_updated" : "2025-01-01T00:00:00.000Z",
      "task_add_on_attributes" : "{}",
      "task_timeout" : 86400,
      "worker_available" : true,
      "reservation_timeout" : 25,
      "reservation_status" : "accepted"
    }
  }
}
```

**Versions**

* [v4 (latest)](https://events-schemas.twilio.com/TaskRouter.WDSEvent/4)
* [v3](https://events-schemas.twilio.com/TaskRouter.WDSEvent/3)
* [v2](https://events-schemas.twilio.com/TaskRouter.WDSEvent/2)
* [v1](https://events-schemas.twilio.com/TaskRouter.WDSEvent/1)

## Timeout

`com.twilio.taskrouter.workflow.timeout`

> \[!NOTE]
>
> The `worker_time_in_previous_activity` field began reporting in seconds starting May 21, 2021. Version 2 of the TaskRouter schema added a new `worker_time_in_previous_activity_ms` field that was not exposed through Event Streams previously. If you want to measure this field in milliseconds, you must use schema version 2.

Workflow Timeout events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/taskrouter/api/event).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.taskrouter.workflow.timeout",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/TaskRouter.WDSEvent/4",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "sid" : "EV0000000000000000000000000000001",
    "name" : "ReservationCreated",
    "account_sid" : "AC0000000000000000000000000000001",
    "account_friendly_name" : "An account name",
    "parent_account_sid" : "AC0000000000000000000000000000001",
    "parent_friendly_name" : "Another account name",
    "timestamp" : "2025-01-01T00:00:00.000Z",
    "level" : "INFO",
    "group" : "reservation",
    "product_name" : "TaskRouter",
    "publisher" : "Flex Task Assignment",
    "publisher_metadata" : "{}",
    "payload_type" : "application/json",
    "payload" : {
      "sid" : "EV0000000000000000000000000000001",
      "eventtype" : "reservation.created",
      "account_sid" : "AC0000000000000000000000000000001",
      "timestamp" : "2025-01-01T00:00:00.000Z",
      "workspace_sid" : "WS0000000000000000000000000000001",
      "workspace_name" : "Flex Task Assignment",
      "task_sid" : "WT0000000000000000000000000000001",
      "task_attributes" : "{}",
      "task_age" : 31088,
      "task_date_created" : "2025-01-01T00:00:00.000Z",
      "task_priority" : 1,
      "task_assignment_status" : "reserved",
      "task_completed_reason" : "All reservations were completed",
      "task_canceled_reason" : "hangup",
      "reason" : "hangup",
      "task_channel_sid" : "TC0000000000000000000000000000001",
      "task_channel_unique_name" : "chat",
      "reservation_sid" : "WR0000000000000000000000000000001",
      "worker_sid" : "WK0000000000000000000000000000001",
      "worker_name" : "Flex Task Assignment",
      "worker_attributes" : "{}",
      "worker_activity_sid" : "WA0000000000000000000000000000001",
      "worker_activity_name" : "handling 2",
      "worker_time_in_previous_activity" : 322,
      "worker_time_in_previous_activity_ms" : 322859,
      "worker_previous_activity_sid" : "WA0000000000000000000000000000002",
      "worker_previous_activity_name" : "handling 1",
      "workflow_sid" : "WW0000000000000000000000000000002",
      "workflow_name" : "My workflow",
      "task_queue_sid" : "WQ0000000000000000000000000000002",
      "task_queue_name" : "My task queue",
      "worker_channel_available" : 1,
      "worker_channel_capacity" : 1,
      "worker_channel_available_capacity" : 100.0,
      "worker_channel_previous_capacity" : 6.0,
      "worker_channel_task_count" : 0,
      "workflow_filter_name" : "My workflow filter name",
      "workflow_filter_expression" : "1==1",
      "workflow_filter_target_expression" : "worker.channel.chat.assigned_tasks <= 1",
      "workflow_filter_target_name" : "My workflow filter target name",
      "previous_task_queue_sid" : "WQ0000000000000000000000000000001",
      "previous_task_queue_name" : "My previous task queue name",
      "previous_task_priority" : 3,
      "target_changed_reason" : "skipped",
      "task_re_evaluated_reason" : "reservation_timeout",
      "task_queue_target_expression" : "allowed_channels HAS \"chat\"",
      "task_transfer_sid" : "TT0000000000000000000000000000001",
      "transfer_type" : "QUEUE",
      "transfer_initiating_worker_sid" : "WK0000000000000000000000000000001",
      "transfer_initiating_reservation_sid" : "WR0000000000000000000000000000001",
      "transfer_to" : "WQ0000000000000000000000000000001",
      "transfer_mode" : "COLD",
      "transfer_started" : "2025-01-01T00:00:00.000Z",
      "transfer_failed_reason" : "",
      "transfer_status" : "complete",
      "event_description" : "Reservation WR0000000000000000000000000000001 created",
      "resource_type" : "reservation",
      "resource_sid" : "WR0000000000000000000000000000001",
      "task_routing_target" : "WK0000000000000000000000000000001",
      "reservation_reason_code" : 45302,
      "task_age_in_queue" : 31086,
      "task_queue_entered_date" : "2025-01-01T00:00:00.000Z",
      "task_version" : 4,
      "reservation_version" : 0,
      "task_virtual_start_time" : "2025-01-01T00:00:00.000Z",
      "worker_channel_consumed_capacity" : 2,
      "worker_version" : 4019,
      "task_channel_name" : "My task channel name",
      "task_channel_optimized_routing" : false,
      "known_worker_sid" : "WK0000000000000000000000000000001",
      "activity_sid" : "WA0000000000000000000000000000001",
      "activity_name" : "My activity name",
      "activity_available" : true,
      "operating_unit_sid" : "OU0000000000000000000000000000001",
      "operating_unit_friendly_name" : "My operating unit",
      "operating_unit_date_created" : "2025-01-01T00:00:00.000Z",
      "operating_unit_date_updated" : "2025-01-01T00:00:00.000Z",
      "task_add_on_attributes" : "{}",
      "task_timeout" : 86400,
      "worker_available" : true,
      "reservation_timeout" : 25,
      "reservation_status" : "accepted"
    }
  }
}
```

**Versions**

* [v4 (latest)](https://events-schemas.twilio.com/TaskRouter.WDSEvent/4)
* [v3](https://events-schemas.twilio.com/TaskRouter.WDSEvent/3)
* [v2](https://events-schemas.twilio.com/TaskRouter.WDSEvent/2)
* [v1](https://events-schemas.twilio.com/TaskRouter.WDSEvent/1)
