> For the complete documentation index, see [llms.txt](https://docs.imerit.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imerit.net/data/importing-and-exporting-annotations/exporting-annotations/ango-export-format/asset.md).

# Asset

{% hint style="info" %}
This page is about the `asset` object in Ango Hub's export file. For more information on assets as they are used in Ango Hub, check out the page named[ Assets](/core-concepts/assets.md).
{% endhint %}

The asset is the main unit in the Ango Annotation Format. When obtaining an export from Ango Hub, you are essentially getting a list of assets.

This page details assets and their available metadata in the export format.

## General Structure

{% code fullWidth="true" %}

```json
{
   asset, // string, URL to the asset. May be signed.
   assetId, // string, unique ID of the asset (only in multi-page assets)
   dataset, // list, URLs of all the images in the asset (only multi-page assets)
   externalId, // string, externalId of the asset
   metadata, // object, metadata of the asset. See below for more.
   batches, // list, batches to which the asset belongs.
   task // object, information pertaining to labeling task, including annotations and more. See below for more.
}
```

{% endcode %}

## Asset Object Properties

<table data-full-width="true"><thead><tr><th width="154">Property</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>asset</code></td><td>the URL to the asset. If you have imported the asset as an URL, this will be the same URL. If you have imported it through drag and drop, this will be a signed URL allowing you to, for a period of 120000 seconds from export generation, download it from the Ango Private Bucket where it resides.<br><br>WARNING: For <a href="/pages/WtbkXC3qX0yD6y1YxlPK">multi-image assets</a>, the <code>asset</code> URL will point to the first image (page 0) of the multi-image asset. To get the URLs of all images in the asset, parse the <code>dataset</code> list below.</td><td><pre class="language-json"><code class="lang-json">"asset": "https://angohub-private-assets.s3.eu-central-1.amazonaws.com/e32d6ab2-d6f7-4e77-b671-88f16ec1f1e8.webm?X-Amz-Algorithm=AWS4-HMAC-SHA256&#x26;X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&#x26;X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20230825%2Feu-central-1%2Fs3%2Faws4_request&#x26;X-Amz-Date=20230825T070837Z&#x26;X-Amz-Expires=120000&#x26;X-Amz-Signature=509890db535e004df9286186dcffb680f63af7526956e6dc4f683c3295a0b6e3&#x26;X-Amz-SignedHeaders=host&#x26;x-id=GetObject"
</code></pre></td></tr><tr><td><code>assetId</code></td><td>ID of the asset. <a href="/pages/WtbkXC3qX0yD6y1YxlPK">Only in multi-image assets</a>.</td><td><pre class="language-json"><code class="lang-json">"taskId": "64e5e5b985eb730015b4ebd9"
</code></pre></td></tr><tr><td><code>dataset</code></td><td>URLs of all images in the assets, starting from page 0 onwards. <a href="/pages/WtbkXC3qX0yD6y1YxlPK">Only in multi-image assets</a>.</td><td><pre class="language-json"><code class="lang-json">"dataset": [
    "https://angohub-public-assets.s3.eu-central-1.amazonaws.com/3e6e15b9-c32c-4b73-97f9-dbda784926ab.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&#x26;X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&#x26;X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20231009%2Feu-central-1%2Fs3%2Faws4_request&#x26;X-Amz-Date=20231009T134740Z&#x26;X-Amz-Expires=120000&#x26;X-Amz-Signature=70790d6813a471f78f51261006f45971af8c0bb73c5266ed90225da2a7e7d5f6&#x26;X-Amz-SignedHeaders=host&#x26;x-id=GetObject",
    "https://angohub-public-assets.s3.eu-central-1.amazonaws.com/8b363eb9-5b7f-414c-89b8-b6907f29447b.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&#x26;X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&#x26;X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20231009%2Feu-central-1%2Fs3%2Faws4_request&#x26;X-Amz-Date=20231009T134740Z&#x26;X-Amz-Expires=120000&#x26;X-Amz-Signature=fab97fcb3a6e457e4acf0525651047942e7349973758b0a533ea03e453bad039&#x26;X-Amz-SignedHeaders=host&#x26;x-id=GetObject"
    ]
</code></pre></td></tr><tr><td><code>externalId</code></td><td>The <a href="/pages/-MjiVNVPrOR3Ud5Vmh5I#external-id">external ID</a> assigned to the asset at import time.</td><td><pre class="language-json"><code class="lang-json">"externalId": "video-webm.webm"
</code></pre></td></tr><tr><td><code>metadata</code></td><td><p>Asset metadata is populated at different times depending on the asset type.</p><p>If the asset is an image, the <code>width</code> and <code>height</code> of the image in pixels, typically populated when the image is first fully loaded in the labeling editor unless they were provided during import.<br><br><br>If the asset is a video, the width/height in pixels of the video, the total number of frames (<code>frameTotal</code>) and the frame rate (<code>frameRate</code>) extracted during asset processing.<br><br>If the asset is a PDF, the total number of pages, typically populated when the asset is first opened in the labeling editor if it was not already known.<br><br>If the asset is a DICOM, the total number of frames.</p></td><td><pre class="language-json"><code class="lang-json"><strong>// image
</strong><strong>"metadata": {
</strong>    "width": 1200,
    "height": 800
  }
</code></pre><pre class="language-json"><code class="lang-json">// video
"metadata": {
    "width": 1200,
    "height": 1200,
    "frameTotal": 507,
    "frameRate": 30
  }
</code></pre><pre class="language-json"><code class="lang-json">// PDF
"metadata": {
    "width": 1200,
    "height": 1200,
    "frameTotal": 507,
    "frameRate": 30
  }
</code></pre><pre class="language-json"><code class="lang-json">// DICOM
"metadata": {
    "width": 512,
    "height": 512,
    "frameTotal": 96
  }
</code></pre></td></tr><tr><td><code>batches</code></td><td><a href="/pages/UG8IQiraVA0IQp9Q2ahI">Batches</a> to which the asset belongs.</td><td><pre class="language-json"><code class="lang-json">"batches": ["batch_1", "batch_2"]
</code></pre></td></tr><tr><td><a href="/pages/mTdfoDbRnviwSLPc2Iji"><code>task</code></a></td><td>The information related to the labeling task that was exported attached to this asset. This includes the annotations themselves as well as metadata related to the task (e.g. annotator identity, annotation time/date, etc.)<br><br>Documentation for the <code>task</code> property can be found <a href="/pages/mTdfoDbRnviwSLPc2Iji">here</a>.</td><td><pre class="language-json"><code class="lang-json">"task": {
    "taskId": "64e5e5b985eb730015b4ebd9",
    "stage": "Complete",
    "stageId": "Complete",
    "updatedAt": "2023-08-23T11:36:38.027Z",
    "updatedBy": "lorenzo@imerit.net",
    "totalDuration": 49596,
    "tools": [
      {
        "bounding-box": {
          "x": 301.6699801192843,
          "y": 429.05027932960894,
          "height": 173.76536312849163,
          "width": 118.09145129224652
        },
        "objectId": "765742a3b676d3f26898792",
        "classifications": [],
        "metadata": {
          "createdAt": "2023-08-23T11:20:32.792Z",
          "createdBy": "lorenzo@imerit.net",
          "createdIn": "Label"
        },
        "schemaId": "b1c6805d054f0e44ae11500",
        "page": 504,
        "title": "bb"
      }
    ],
    "classifications": [
      {
        "objectId": "3d5cd10ba190b29d2850724",
        "schemaId": "6421df1fa34ac13204ea157",
        "tool": "radio",
        "title": "rdo",
        "answer": "1",
        "metadata": {
          "createdAt": "2023-08-23T11:20:51.725Z",
          "createdBy": "lorenzo@imerit.net",
          "createdIn": "Label"
        },
        "classifications": []
      }
    ],
    "relations": [
      {
        "from": "9f4487231d385821865b486",
        "to": "9a1311e463600e8eb98f342",
        "objectId": "73b8926ffd17e3b000e4752",
        "schemaId": "8f8e617174718e80bbea268",
        "direction": "straight",
        "metadata": {
          "createdAt": "2023-08-23T11:32:33.752Z",
          "createdBy": "lorenzo@imerit.net",
          "createdIn": "Label"
        },
        "page": 0,
        "title": "sng"
      }
    ],
    "stageHistory": [
      {
        "stage": "Start",
        "stageId": "Start",
        "duration": 0,
        "completedAt": "2023-08-23T10:55:53.495Z",
        "tools": [],
        "classifications": [],
        "relations": []
      },
      { ... }
    ]
  }
</code></pre></td></tr></tbody></table>

<details>

<summary>Sample Asset</summary>

```json
{
    "asset": "https://angohub-private-assets.s3.eu-central-1.amazonaws.com/e32d6ab2-d6f7-4e77-b671-88f16ec1f1e8.webm?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20230825%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20230825T070837Z&X-Amz-Expires=120000&X-Amz-Signature=509890db535e004df9286186dcffb680f63af7526956e6dc4f683c3295a0b6e3&X-Amz-SignedHeaders=host&x-id=GetObject",
    "externalId": "video-webm.webm",
    "metadata": {
        "frameTotal": 507,
        "frameRate": 30
    },
    "batches": [],
    "task": {
        "taskId": "64e5e5b985eb730015b4ebd9",
        "stage": "Complete",
        "stageId": "Complete",
        "updatedAt": "2023-08-23T11:36:38.027Z",
        "updatedBy": "lorenzo@imerit.net",
        "totalDuration": 49596,
        "tools": [
            {
                "bounding-box": {
                    "x": 301.6699801192843,
                    "y": 429.05027932960894,
                    "height": 173.76536312849163,
                    "width": 118.09145129224652
                },
                "objectId": "765742a3b676d3f26898792",
                "classifications": [],
                "metadata": {
                    "createdAt": "2023-08-23T11:20:32.792Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "schemaId": "b1c6805d054f0e44ae11500",
                "page": 504,
                "title": "bb"
            },
            {
                "polygon": [
                    [
                        593.6779324055666,
                        1121.9664804469273
                    ],
                    [
                        443.3797216699801,
                        1349.36312849162
                    ],
                    [
                        576.5009940357853,
                        1375.1061452513966
                    ]
                ],
                "objectId": "408deff4664cc342d236127",
                "classifications": [],
                "metadata": {
                    "createdAt": "2023-08-23T11:20:37.127Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "schemaId": "a966c7799383465850cd803",
                "page": 504,
                "title": "gon"
            },
            {
                "objectId": "765742a3b676d3f26898792",
                "schemaId": "b1c6805d054f0e44ae11500",
                "classifications": [],
                "bounding-box": {
                    "x": 801.948310139165,
                    "y": 1428.7374301675977,
                    "height": 173.76536312849163,
                    "width": 118.09145129224652
                },
                "metadata": {
                    "createdAt": "2023-08-23T11:20:40.952Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "page": 506,
                "title": "bb"
            },
            {
                "objectId": "408deff4664cc342d236127",
                "schemaId": "a966c7799383465850cd803",
                "classifications": [],
                "polygon": [
                    [
                        217.93240556660038,
                        229.54189944134077
                    ],
                    [
                        67.63419483101391,
                        456.9385474860335
                    ],
                    [
                        200.75546719681907,
                        482.68156424581
                    ]
                ],
                "metadata": {
                    "createdAt": "2023-08-23T11:20:42.215Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "page": 506,
                "title": "gon"
            }
        ],
        "classifications": [
            {
                "objectId": "3d5cd10ba190b29d2850724",
                "schemaId": "6421df1fa34ac13204ea157",
                "tool": "radio",
                "title": "rdo",
                "answer": "1",
                "metadata": {
                    "createdAt": "2023-08-23T11:20:51.725Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "classifications": []
            },
            {
                "objectId": "f4e53917c222c8e62dbb715",
                "schemaId": "1ea7a275ce5c9cf30a6f148",
                "tool": "checkbox",
                "title": "chk",
                "answer": [
                    "1"
                ],
                "metadata": {
                    "createdAt": "2023-08-23T11:20:52.716Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "classifications": []
            },
            {
                "objectId": "0b057a52a2bb648b197f180",
                "schemaId": "a2b4a50bb90eb6523b88376",
                "tool": "single-dropdown",
                "title": "sdr",
                "answer": "1",
                "metadata": {
                    "createdAt": "2023-08-23T11:20:54.180Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "classifications": []
            },
            {
                "objectId": "19ae5491832a3bd42704684",
                "schemaId": "11f6ed8e4ac4852d3422341",
                "tool": "multi-dropdown",
                "title": "mdr",
                "answer": [
                    "1"
                ],
                "metadata": {
                    "createdAt": "2023-08-23T11:20:55.684Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "classifications": []
            },
            {
                "objectId": "7ed41243066d9b09e652723",
                "schemaId": "c2b5eb27e55b186f84f3898",
                "tool": "tree-dropdown",
                "title": "tre",
                "answer": [
                    "1",
                    "1 / 2"
                ],
                "metadata": {
                    "createdAt": "2023-08-23T11:20:59.723Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label",
                    "updatedAt": "2023-08-23T11:21:01.940Z",
                    "updatedBy": "lorenzo@imerit.net",
                    "updatedIn": "Label"
                },
                "classifications": []
            },
            {
                "objectId": "bde3bab1fbdbcecdc891100",
                "schemaId": "6590a72d09f1760a4578032",
                "tool": "text",
                "title": "txt",
                "answer": "2",
                "metadata": {
                    "createdAt": "2023-08-23T11:21:01.100Z",
                    "createdBy": "lorenzo@imerit.net",
                    "createdIn": "Label"
                },
                "classifications": []
            }
        ],
        "relations": [],
        "stageHistory": [
            {
                "stage": "Start",
                "stageId": "Start",
                "duration": 0,
                "completedAt": "2023-08-23T10:55:53.495Z",
                "tools": [],
                "classifications": [],
                "relations": []
            },
            {
                "stage": "Label",
                "stageId": "Label",
                "duration": 46753,
                "completedAt": "2023-08-23T11:21:04.393Z",
                "completedBy": "lorenzo@imerit.net",
                "tools": [
                    {
                        "bounding-box": {
                            "x": 301.6699801192843,
                            "y": 429.05027932960894,
                            "height": 173.76536312849163,
                            "width": 118.09145129224652
                        },
                        "objectId": "765742a3b676d3f26898792",
                        "classifications": [],
                        "schemaId": "b1c6805d054f0e44ae11500",
                        "page": 504,
                        "title": "bb"
                    },
                    {
                        "polygon": [
                            [
                                593.6779324055666,
                                1121.9664804469273
                            ],
                            [
                                443.3797216699801,
                                1349.36312849162
                            ],
                            [
                                576.5009940357853,
                                1375.1061452513966
                            ]
                        ],
                        "objectId": "408deff4664cc342d236127",
                        "classifications": [],
                        "schemaId": "a966c7799383465850cd803",
                        "page": 504,
                        "title": "gon"
                    },
                    {
                        "objectId": "765742a3b676d3f26898792",
                        "schemaId": "b1c6805d054f0e44ae11500",
                        "classifications": [],
                        "bounding-box": {
                            "x": 801.948310139165,
                            "y": 1428.7374301675977,
                            "height": 173.76536312849163,
                            "width": 118.09145129224652
                        },
                        "page": 506,
                        "title": "bb"
                    },
                    {
                        "objectId": "408deff4664cc342d236127",
                        "schemaId": "a966c7799383465850cd803",
                        "classifications": [],
                        "polygon": [
                            [
                                217.93240556660038,
                                229.54189944134077
                            ],
                            [
                                67.63419483101391,
                                456.9385474860335
                            ],
                            [
                                200.75546719681907,
                                482.68156424581
                            ]
                        ],
                        "page": 506,
                        "title": "gon"
                    }
                ],
                "classifications": [
                    {
                        "objectId": "3d5cd10ba190b29d2850724",
                        "schemaId": "6421df1fa34ac13204ea157",
                        "tool": "radio",
                        "title": "rdo",
                        "answer": "1",
                        "classifications": []
                    },
                    {
                        "objectId": "f4e53917c222c8e62dbb715",
                        "schemaId": "1ea7a275ce5c9cf30a6f148",
                        "tool": "checkbox",
                        "title": "chk",
                        "answer": [
                            "1"
                        ],
                        "classifications": []
                    },
                    {
                        "objectId": "0b057a52a2bb648b197f180",
                        "schemaId": "a2b4a50bb90eb6523b88376",
                        "tool": "single-dropdown",
                        "title": "sdr",
                        "answer": "1",
                        "classifications": []
                    },
                    {
                        "objectId": "19ae5491832a3bd42704684",
                        "schemaId": "11f6ed8e4ac4852d3422341",
                        "tool": "multi-dropdown",
                        "title": "mdr",
                        "answer": [
                            "1"
                        ],
                        "classifications": []
                    },
                    {
                        "objectId": "7ed41243066d9b09e652723",
                        "schemaId": "c2b5eb27e55b186f84f3898",
                        "tool": "tree-dropdown",
                        "title": "tre",
                        "answer": [
                            "1",
                            "1 / 2"
                        ],
                        "classifications": []
                    },
                    {
                        "objectId": "bde3bab1fbdbcecdc891100",
                        "schemaId": "6590a72d09f1760a4578032",
                        "tool": "text",
                        "title": "txt",
                        "answer": "2",
                        "classifications": []
                    }
                ],
                "relations": []
            },
            {
                "stage": "Review",
                "stageId": "5e8f78a7-ef6a-473d-b02f-f4024c9ee486",
                "duration": 2843,
                "reviewStatus": "Accepted",
                "completedAt": "2023-08-23T11:36:38.074Z",
                "completedBy": "lorenzo@imerit.net",
                "tools": [
                    {
                        "bounding-box": {
                            "x": 301.6699801192843,
                            "y": 429.05027932960894,
                            "height": 173.76536312849163,
                            "width": 118.09145129224652
                        },
                        "objectId": "765742a3b676d3f26898792",
                        "classifications": [],
                        "schemaId": "b1c6805d054f0e44ae11500",
                        "page": 504,
                        "title": "bb"
                    },
                    {
                        "polygon": [
                            [
                                593.6779324055666,
                                1121.9664804469273
                            ],
                            [
                                443.3797216699801,
                                1349.36312849162
                            ],
                            [
                                576.5009940357853,
                                1375.1061452513966
                            ]
                        ],
                        "objectId": "408deff4664cc342d236127",
                        "classifications": [],
                        "schemaId": "a966c7799383465850cd803",
                        "page": 504,
                        "title": "gon"
                    },
                    {
                        "objectId": "765742a3b676d3f26898792",
                        "schemaId": "b1c6805d054f0e44ae11500",
                        "classifications": [],
                        "bounding-box": {
                            "x": 801.948310139165,
                            "y": 1428.7374301675977,
                            "height": 173.76536312849163,
                            "width": 118.09145129224652
                        },
                        "page": 506,
                        "title": "bb"
                    },
                    {
                        "objectId": "408deff4664cc342d236127",
                        "schemaId": "a966c7799383465850cd803",
                        "classifications": [],
                        "polygon": [
                            [
                                217.93240556660038,
                                229.54189944134077
                            ],
                            [
                                67.63419483101391,
                                456.9385474860335
                            ],
                            [
                                200.75546719681907,
                                482.68156424581
                            ]
                        ],
                        "page": 506,
                        "title": "gon"
                    }
                ],
                "classifications": [
                    {
                        "objectId": "3d5cd10ba190b29d2850724",
                        "schemaId": "6421df1fa34ac13204ea157",
                        "tool": "radio",
                        "title": "rdo",
                        "answer": "1",
                        "classifications": []
                    },
                    {
                        "objectId": "f4e53917c222c8e62dbb715",
                        "schemaId": "1ea7a275ce5c9cf30a6f148",
                        "tool": "checkbox",
                        "title": "chk",
                        "answer": [
                            "1"
                        ],
                        "classifications": []
                    },
                    {
                        "objectId": "0b057a52a2bb648b197f180",
                        "schemaId": "a2b4a50bb90eb6523b88376",
                        "tool": "single-dropdown",
                        "title": "sdr",
                        "answer": "1",
                        "classifications": []
                    },
                    {
                        "objectId": "19ae5491832a3bd42704684",
                        "schemaId": "11f6ed8e4ac4852d3422341",
                        "tool": "multi-dropdown",
                        "title": "mdr",
                        "answer": [
                            "1"
                        ],
                        "classifications": []
                    },
                    {
                        "objectId": "7ed41243066d9b09e652723",
                        "schemaId": "c2b5eb27e55b186f84f3898",
                        "tool": "tree-dropdown",
                        "title": "tre",
                        "answer": [
                            "1",
                            "1 / 2"
                        ],
                        "classifications": []
                    },
                    {
                        "objectId": "bde3bab1fbdbcecdc891100",
                        "schemaId": "6590a72d09f1760a4578032",
                        "tool": "text",
                        "title": "txt",
                        "answer": "2",
                        "classifications": []
                    }
                ],
                "relations": []
            }
        ]
    }
}
```

</details>
