# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.imerit.net/data/importing-and-exporting-annotations/exporting-annotations/ango-export-format/asset.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
