Copy page

Task

TaskAssigneeChangedEvent

Event emitted when a task's assignee is changed. This allows external systems to react to assignee changes.

Field	Value
Topic	task.task_assignee_changed
Schema ID	BritecoreTaskAssigneeChanged.v1
Version	1.0.0

Payload schema

Code
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.britecore.com/schemas/events/task_assignee_changed.json",
  "title": "TaskAssigneeChangedEvent",
  "description": "Event emitted when a task's assignee is changed. This allows external systems to react to assignee changes.",
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string",
      "format": "uuid",
      "description": "Unique identifier for this event instance."
    },
    "event_date": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp the event was emitted (UTC)."
    },
    "schema_id": {
      "type": "string",
      "description": "Schema identifier. Stable per event type.",
      "const": "BritecoreTaskAssigneeChanged.v1"
    },
    "version": {
      "type": "string",
      "description": "Schema version.",
      "const": "1.0.0"
    },
    "topic": {
      "type": "string",
      "description": "Topic the event was published on."
    },
    "triggering_user": {
      "type": "object",
      "description": "User that triggered the event.",
      "properties": {
        "id": {
          "type": "string"
        },
        "external_system_reference": {
          "type": "string"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "task_id": {
          "type": "integer"
        },
        "task_number": {
          "type": "integer"
        },
        "task_type_id": {
          "type": "integer"
        },
        "task_type_name": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "priority": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "claim_id": {
          "type": "integer"
        },
        "policy_id": {
          "type": "integer"
        },
        "old_assignee_id": {
          "type": "integer"
        },
        "old_assignee_name": {
          "type": "string"
        },
        "old_assignee_email": {
          "type": "string"
        },
        "new_assignee_id": {
          "type": "integer"
        },
        "new_assignee_name": {
          "type": "string"
        },
        "new_assignee_email": {
          "type": "string"
        }
      },
      "required": [
        "task_id",
        "task_number",
        "status",
        "priority",
        "description",
        "old_assignee_email",
        "new_assignee_email"
      ]
    }
  },
  "required": [
    "event_id",
    "event_date",
    "schema_id",
    "version",
    "topic",
    "data"
  ]
}

The schema is also published as a standalone JSON Schema artefact you can fetch and consume programmatically. See schemas/events/task_assignee_changed.json on the published portal.

Example payload

Code
{
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_date": "2026-01-01T00:00:00Z",
  "schema_id": "BritecoreTaskAssigneeChanged.v1",
  "version": "1.0.0",
  "topic": "task.task_assignee_changed",
  "data": {
    "task_id": 0,
    "task_number": 0,
    "task_type_id": 0,
    "task_type_name": "string",
    "status": "string",
    "priority": "string",
    "description": "string",
    "claim_id": 0,
    "policy_id": 0,
    "old_assignee_id": 0,
    "old_assignee_name": "string",
    "old_assignee_email": "string",
    "new_assignee_id": 0,
    "new_assignee_name": "string",
    "new_assignee_email": "string"
  }
}

Notes