Events

Project created

A PROJECT_CREATED event will be sent when a new project is created.

Example

Request body

All JSON examples have been prettified for documentation purposes.

{
  "eventType": "PROJECT_CREATED",
  "data": {
    "timestamp": "2023-11-17T09:02:45.258Z",
    "project": {
      "id": "N2E4MjNlYTc",
      "name": "hamlet.TXT",
      "tags": [
        "CUSTOM"
      ]
    },
    "team": {
      "id": "1",
      "name": "User's Team Workspace"
    }
  }
}

Request header

{
  "accept-encoding": "gzip, compress, deflate, br",
  "accept": "application/json, text/plain, */*",
  "content-length": "200",
  "content-type": "application/json",
  "user-agent": "Datasaur",
  "x-datasaur-signature": "643a34cd1a649b37a6d3611ff7fb561a0255e899ca89a9475c79b38764775033"
}

Before update labels

A BEFORE_UPDATE_LABELS event will be sent just before the labeler apply a new label or update an existing label.

Example

Request body

{
  "eventType": "BEFORE_UPDATE_LABELS",
  "data": {
    "timestamp": "2023-11-17T09:49:54.108Z",
    "document": {
      "id": "cdf0631f-66b6-4330-be05-4c87fd169afb",
      "originId": "97812272-e8cd-4f92-97e3-e83de1e33db0",
      "name": "hamlet.TXT",
      "fileName": "hamlet.TXT",
      "createdAt": "2023-11-17T09:48:41.000Z",
      "lastSavedAt": "2023-11-17T09:48:41.048Z"
    },
    "isReviewDocument": false,
    "labelUpdateList": {
      "toDeleteList": [],
      "toUpsertList": [
        {
          "documentId": "cdf0631f-66b6-4330-be05-4c87fd169afb",
          "startCellIndex": 0,
          "startCellLine": 0,
          "startTokenIndex": 0,
          "startCharIndex": 0,
          "endCellIndex": 0,
          "endCellLine": 0,
          "endTokenIndex": 0,
          "endCharIndex": 2,
          "counter": 0,
          "layer": 0,
          "labeledBy": "LABELER",
          "type": "SPAN",
          "labelSetItemId": "geo",
          "confidenceScore": null,
          "labeledByUserId": 1
        }
      ]
    },
    "owner": {
      "id": "1",
      "email": "[e-mail]",
      "username": "",
      "name": ""
    },
    "team": {
      "id": "1"
    }
  }
}

Request header

{
  "accept-encoding": "gzip, compress, deflate, br",
  "accept": "application/json, text/plain, */*",
  "content-length": "808",
  "content-type": "application/json",
  "user-agent": "Datasaur",
  "x-datasaur-signature": "4dd97f9908612bc4d0a7bc7bd0135c72fd5cc51a47e465f274233732e4733271"
}

Project completed

Project labeled

A PROJECT_LABELED event will be sent when a labeler marks a project as complete in Labeler mode.

Example

Request body

{
  "eventType": "PROJECT_LABELED",
  "data": {
    "timestamp": "2023-11-17T09:52:57.478Z",
    "labeler": {
      "id": "1",
      "email": "[e-mail]",
      "username": "",
      "name": ""
    },
    "project": {
      "id": "ZTYzZjRhYjE",
      "name": "hamlet.TXT",
      "tags": [
        "CUSTOM"
      ]
    },
    "team": {
      "id": "1"
    }
  }
}

Request header

{
  "accept-encoding": "gzip, compress, deflate, br",
  "accept": "application/json, text/plain, */*",
  "content-length": "243",
  "content-type": "application/json",
  "user-agent": "Datasaur",
  "x-datasaur-signature": "<calculated based on the configured webhook secret>"
}

Project reviewed

A PROJECT_REVIEWED event will be sent after the reviewer marks the project as complete in Reviewer mode.

Example

Request body

{
  "eventType": "PROJECT_REVIEWED",
  "data": {
    "timestamp": "2023-11-17T09:53:23.514Z",
    "reviewer": {
      "id": "1",
      "email": "[e-mail]",
      "username": "",
      "name": ""
    },
    "project": {
      "id": "ZTYzZjRhYjE",
      "name": "hamlet.TXT",
      "tags": [
        "CUSTOM"
      ]
    },
    "team": {
      "id": "1"
    }
  }
}

Request header

{
  "accept-encoding": "gzip, compress, deflate, br",
  "accept": "application/json, text/plain, */*",
  "content-length": "243",
  "content-type": "application/json",
  "user-agent": "Datasaur",
  "x-datasaur-signature": "f9e52fba3fe2f74467f81dd7b3f0569610ffc4b428ad23939d69621d13af0a68"
}

Document completed

A DOCUMENT_COMPLETED event will be sent after the reviewer or labeler marks the document as complete in Reviewer or Labeler mode.

Example

Request body labeler

{
  "eventType": "DOCUMENT_COMPLETED",
  "data": {
    "timestamp": "2026-07-28T06:09:49.131Z",
    "document": {
      "id": "f5b6ffb2-4efc-44f3-909e-f417cac7a91e",
      "originId": "7492cd48-21bd-486e-9300-bd474e2b4d2d",
      "name": "CoffeeReview.txt",
      "fileName": "CoffeeReview.txt",
      "createdAt": "2026-07-28T06:09:44.000Z",
      "lastSavedAt": "2026-07-28T06:09:46.747Z"
    },
    "documentName": "CoffeeReview.txt",
    "project": {
      "id": "MThlMDFjNjg",
      "name": "1",
      "tags": [
        "CUSTOM"
      ]
    },
    "team": {
      "id": "1"
    },
    "cabinet": {
      "id": "12",
      "documentType": "DOCUMENT",
      "ownerId": "1",
      "owner": {
        "id": "1",
        "email": "[e-mail]",
        "username": "",
        "name": "lucas+1",
        "isLabelingAgent": false
      }
    },
    "isReviewDocument": false,
    "completedByUser": {
      "id": "1",
      "email": "[e-mail]",
      "username": "",
      "name": "lucas+1",
      "isLabelingAgent": false
    }
  }
}

Request header labeler

{
  "accept": "application/json, text/plain, */*",
  "accept-encoding": "gzip, compress, deflate, br",
  "content-length": "742",
  "content-type": "application/json",
  "user-agent": "Datasaur",
  "x-datasaur-signature": "f627be75730c72272aba33be15cf1a745de7b1f75da90ff8c13e3be2eb5d39e3"
}

Request body reviewer

{
  "eventType": "DOCUMENT_COMPLETED",
  "data": {
    "timestamp": "2026-07-28T06:12:48.799Z",
    "document": {
      "id": "b538f6a8-6d5a-4d5a-b126-2ac713727592",
      "originId": "7492cd48-21bd-486e-9300-bd474e2b4d2d",
      "name": "CoffeeReview.txt",
      "fileName": "CoffeeReview.txt",
      "createdAt": "2026-07-28T06:09:41.000Z",
      "lastSavedAt": "2026-07-28T06:12:46.305Z"
    },
    "documentName": "CoffeeReview.txt",
    "project": {
      "id": "MThlMDFjNjg",
      "name": "1",
      "tags": [
        "CUSTOM"
      ]
    },
    "team": {
      "id": "1"
    },
    "cabinet": {
      "id": "11",
      "documentType": "REVIEW",
      "ownerId": "1",
      "owner": {
        "id": "1",
        "email": "[e-mail]",
        "username": "",
        "name": "lucas+1",
        "isLabelingAgent": false
      }
    },
    "isReviewDocument": true,
    "completedByUser": {
      "id": "1",
      "email": "[e-mail]",
      "username": "",
      "name": "lucas+1",
      "isLabelingAgent": false
    }
  }
}

Request header reviewer

{
  "accept": "application/json, text/plain, */*",
  "accept-encoding": "gzip, compress, deflate, br",
  "content-length": "739",
  "content-type": "application/json",
  "user-agent": "Datasaur",
  "x-datasaur-signature": "d02aba6dab9444dab3183c458eab1c429fbc9dd073f6b280cb34332e6e15f33d"
}