Notification format

  1. Example of the POOL_CLOSED notification body
  2. Example of the ASSIGNMENT_ notification body
  3. Example of the DYNAMIC_OVERLAP_COMPLETED notification body

When an event that a subscription is created for occurs, a notification is sent to the URL specified in the subscription. It will contain all data about the object as of the event time.

Notifications are sent in JSON format.

{
    "events":
    [
      {Event data 1},
      {Event data 2},
      {Event data N}
    ]
  }

Data included in a notification depends on the event type.

Example of the POOL_CLOSED notification body

{
  "uuid": "uuid-1",
  "event_time": "2020-02-14T12:22:58",
  "project_id": "project-1",
  "pool_id": "pool-1",
  "close_reason": "MANUAL",
  "webhook_subscription_id": "subscription-1",
  "type": "POOL_CLOSED"
}
Parameter Overview

uuid

string

Unique event ID.

event_time

string

Time when the event occurs.

project_id

string

ID of the project that the pool was created for.

pool_id

string

ID of the pool that the subscription was created for.

close_reason

string

Reason for closing the pool.

webhook_subscription_id

string

ID of the subscription.

type

string

Event type.

Possible value: POOL_CLOSED — The pool is closed.

Parameter Overview

uuid

string

Unique event ID.

event_time

string

Time when the event occurs.

project_id

string

ID of the project that the pool was created for.

pool_id

string

ID of the pool that the subscription was created for.

close_reason

string

Reason for closing the pool.

webhook_subscription_id

string

ID of the subscription.

type

string

Event type.

Possible value: POOL_CLOSED — The pool is closed.

Example of the ASSIGNMENT_ notification body

{
  "uuid": "uuid-1",
  "event_time": "2020-02-14T12:23:05",
  "project_id": "project-1",
  "pool_id": "pool-1",
  "task_suite_id": "task suite-1",
  "assignment_id": "assignment-1",
  "webhook_subscription_id": "subscription-1",
  "type": "ASSIGNMENT_CREATED"
}
Parameter Overview

uuid

string

Unique event ID.

event_time

string

Time when the event occurs.

project_id

string

ID of the project that the pool was created for.

pool_id

string

ID of the pool that the subscription was created for.

task_suite_id

string

ID of a task suite.

assignment_id

string

ID of the task suite assignment to a user.

webhook_subscription_id

string

ID of the subscription.

type

string

Event type.

Acceptable values:

  • ASSIGNMENT_CREATED — A task is created.
  • ASSIGNMENT_SUBMITTED — A task is completed and waiting for acceptance by the requester.
  • ASSIGNMENT_SKIPPED — A task was taken by the performer who then skipped it and won't return to it.
  • ASSIGNMENT_EXPIRED — A task was taken by the performer who failed to complete it within the time allowed or rejected it before it expired.
  • ASSIGNMENT_APPROVED — A task was completed by the performer and approved by the requester.
  • ASSIGNMENT_REJECTED — A task was completed by the performer but rejected by the requester.
Parameter Overview

uuid

string

Unique event ID.

event_time

string

Time when the event occurs.

project_id

string

ID of the project that the pool was created for.

pool_id

string

ID of the pool that the subscription was created for.

task_suite_id

string

ID of a task suite.

assignment_id

string

ID of the task suite assignment to a user.

webhook_subscription_id

string

ID of the subscription.

type

string

Event type.

Acceptable values:

  • ASSIGNMENT_CREATED — A task is created.
  • ASSIGNMENT_SUBMITTED — A task is completed and waiting for acceptance by the requester.
  • ASSIGNMENT_SKIPPED — A task was taken by the performer who then skipped it and won't return to it.
  • ASSIGNMENT_EXPIRED — A task was taken by the performer who failed to complete it within the time allowed or rejected it before it expired.
  • ASSIGNMENT_APPROVED — A task was completed by the performer and approved by the requester.
  • ASSIGNMENT_REJECTED — A task was completed by the performer but rejected by the requester.

Example of the DYNAMIC_OVERLAP_COMPLETED notification body

{
  "uuid": "uuid-1",
  "event_time": "2020-02-14T12:23:05",
  "project_id": "project-1",
  "pool_id": "pool-2",
  "task_id": "task-1",
  "confidence": 0.155,
  "webhook_subscription_id": "subscription-1",
  "type": "DYNAMIC_OVERLAP_COMPLETED",
  "assignment_ids": ["assignment-1", "assignment-2"],
  "output_values": {
    "field_one": "value-1"
  }
}
Parameter Overview

uuid

string

Unique event ID.

event_time

string

Time when the event occurs.

project_id

string

ID of the project that the pool was created for.

pool_id

string

ID of the pool that the subscription was created for.

task_id

string

Task ID.

confidence

integer

Confidence in the aggregate response.

webhook_subscription_id

string

ID of the subscription.

type

string

Event type.

Possible value: DYNAMIC_OVERLAP_COMPLETED — An aggregated score appeared after dynamic overlap.

assignment_ids[]

array of strings

IDs of task suite assignments to users.

output_values[]

array of objects

Output data fields that contain the task text (field_one) and response.

Parameter Overview

uuid

string

Unique event ID.

event_time

string

Time when the event occurs.

project_id

string

ID of the project that the pool was created for.

pool_id

string

ID of the pool that the subscription was created for.

task_id

string

Task ID.

confidence

integer

Confidence in the aggregate response.

webhook_subscription_id

string

ID of the subscription.

type

string

Event type.

Possible value: DYNAMIC_OVERLAP_COMPLETED — An aggregated score appeared after dynamic overlap.

assignment_ids[]

array of strings

IDs of task suite assignments to users.

output_values[]

array of objects

Output data fields that contain the task text (field_one) and response.