Stage History

The stageHistory object is part of the task object in the Ango Annotation Format.

Each asset, in Ango Hub, goes through workflow stages. The stageHistory object contains a 'snapshot' of the task object of the asset as it left each stage before the stage of which the export was taken.

For example, if the asset went through Start, then a Label stage, then Review then Complete, and you get the export of all assets in the Complete stage, the stageHistory object of all assets in the export will contain the task object of the asset as it left each previous stage, so Start, Label, and Review.

General Structure

"stageHistory" : [
    { <task object of asset as it was in first stage },
    { <task object of asset as it was in second stage },
    { ... }
]

Sample Stage History

{
  "stageHistory": [
    {
      "stage": "Start",
      "stageId": "Start",
      "duration": 0,
      "completedAt": "2023-09-01T08:03:00.751Z",
      "tools": [],
      "classifications": [],
      "relations": []
    },
    {
      "stage": "Label",
      "stageId": "Label",
      "duration": 8217,
      "startedAt": "2023-09-01T08:03:03.104Z",
      "completedAt": "2023-09-01T08:05:21.104Z",
      "completedBy": "[e-mail]",
      "tools": [
        {
          "bounding-box": {
            "x": 311.9559633027523,
            "y": 239.8383838383839,
            "height": 220.44444444444446,
            "width": 132.40366972477065
          },
          "objectId": "3d94d5ead7fcc14859ee425",
          "classifications": [],
          "schemaId": "b1c6805d054f0e44ae11500",
          "title": "bb"
        }
      ],
      "classifications": [],
      "relations": [],
      "brushDataUrl": "https://angohub-private-assets.s3.eu-central-1.amazonaws.com/64f19ab4c54a4d0015562a8f-1693555519699.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20230906%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20230906T103943Z&X-Amz-Expires=120000&X-Amz-Signature=5d45f1475af4c9bdfa420c8c528ec132438b393ebfa81fd3cb20fc1f534a99b7&X-Amz-SignedHeaders=host&x-id=GetObject"
    }
  ]
}

Stage timing

Each completed stage can include a startedAt timestamp. This ISO 8601 value estimates when work began in that stage from the active and idle durations recorded when the task was first saved or submitted. Together, startedAt and completedAt show the elapsed time span of the stage, while duration, idleDuration, and blurDuration describe the tracked activity within that span.

When a task leaves a stage, its startedAt value is retained in the corresponding stageHistory entry. Requeue history entries also include startedAt.