Import/Export

Bulk data import and export

Submit Annotation

post
/annotate/{taskId}

Submits annotation answer for a task

Authorizations
Path parameters
taskIdstringRequired

Task ID

Query parameters
isPluginstring · enumOptional

Set to 'true' if annotation from plugin

Possible values:
Body
answerobjectRequired

Annotation answer object (structure depends on project categorySchema)

Responses
200

Annotation submitted successfully

application/json
post
/annotate/{taskId}
curl -X POST "https://imeritapi.ango.ai/v2/annotate/task123?isPlugin=false" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "answer": {
      "objects": [
        {
          "schemaId": "box-tool-id",
          "bounding-box": {
            "x": 100,
            "y": 100,
            "width": 200,
            "height": 150
          },
          "title": "Car"
        }
      ]
    }
  }'
200

Annotation submitted successfully

{
  "status": "success",
  "data": {
    "label": {
      "_id": "text",
      "project": "text",
      "asset": "text",
      "stage": "text",
      "status": "text",
      "assignee": "text",
      "externalId": "text",
      "batches": [
        "text"
      ],
      "priority": 1,
      "answer": {},
      "createdAt": "2025-10-27T16:45:58.640Z",
      "completedAt": "2025-10-27T16:45:58.640Z",
      "duration": 1
    }
  }
}

Import Attachments

post
/attachments

Imports attachments and associates them with assets

Authorizations
Body
projectstringRequired
Responses
200

Attachments imported successfully

application/json
post
/attachments
curl -X POST "https://imeritapi.ango.ai/v2/attachments" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "507f1f77bcf86cd799439011",
    "attachments": [
      {
        "externalId": "image-001",
        "attachmentUrl": "https://example.com/attachment1.pdf",
        "attachmentType": "pdf"
      },
      {
        "assetId": "asset123",
        "attachmentUrl": "https://example.com/attachment2.doc",
        "attachmentType": "document"
      }
    ]
  }'
200

Attachments imported successfully

{
  "status": "success",
  "data": {
    "project": {
      "attachmentsImported": 1,
      "assetsUpdated": 1
    }
  }
}

Import Labels

post
/import/labels

Imports pre-labeled data into a project

Authorizations
Body
projectstringRequired
Responses
200

Labels imported successfully

application/json
post
/import/labels
curl -X POST "https://imeritapi.ango.ai/v2/import/labels" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "507f1f77bcf86cd799439011",
    "labels": [
      {
        "externalId": "image-001",
        "answer": {
          "objects": [
            {
              "schemaId": "box-tool-id",
              "bounding-box": {
                "x": 100,
                "y": 100,
                "width": 200,
                "height": 150
              },
              "title": "Car"
            }
          ]
        },
        "status": "Completed"
      },
      {
        "assetId": "asset456",
        "answer": {
          "objects": []
        }
      }
    ]
  }'
200

Labels imported successfully

{
  "status": "success",
  "data": {
    "project": "50 / 50 tasks are labeled."
  }
}

Export Tasks

get
/export

Exports task data from projects in various formats

Authorizations
Query parameters
projectstringRequired

Project ID

Example: 507f1f77bcf86cd799439011
formatstring · enumOptional

Export format

Default: jsonPossible values:
typestring · enumOptional

Export type (task or issue)

Default: taskPossible values:
stagestringOptional

Filter by stages (JSON array string, e.g., ["Complete"])

Example: ["Complete"]
batchesstringOptional

Filter by batches (JSON array string, e.g., ["Batch1"])

Example: ["Batch1"]
sendEmailstring · enumOptional

Send export download link via email

Default: falsePossible values:
doNotNotifystring · enumOptional

Do not send notifications about export

Default: falsePossible values:
includeMetadatastring · enumOptional

Include asset metadata in export

Default: falsePossible values:
includeHistorystring · enumOptional

Include task history (all state changes)

Default: falsePossible values:
includeOnlyKeyFramesstring · enumOptional

Include only key frames for video annotations

Default: falsePossible values:
includeIdleBlurDurationsstring · enumOptional

Include idle and blur duration statistics

Default: falsePossible values:
updatedAtstringOptional

Filter by update date (JSON object, e.g., {"$gt":"2020-08-19T07:37:15.000000Z","$lt":"2020-08-26T07:37:15.000000Z"})

Example: {"$gt":"2020-08-19T07:37:15.000000Z","$lt":"2020-08-26T07:37:15.000000Z"}
createdAtstringOptional

Filter by creation date (JSON object, e.g., {"$gt":"2020-07-27T07:37:15.000000Z","$lt":"2020-08-26T07:37:15.000000Z"})

Example: {"$gt":"2020-07-27T07:37:15.000000Z","$lt":"2020-08-26T07:37:15.000000Z"}
Responses
200

Export prepared successfully

application/json
get
/export
curl -X GET "https://imeritapi.ango.ai/v2/export?project=507f1f77bcf86cd799439011&format=json" \
  -H "apikey: YOUR_API_KEY"
200

Export prepared successfully

{
  "status": "success",
  "data": {
    "exportPath": "https://bucket.s3.amazonaws.com/exports/export-2025-01-17.json"
  }
}

Last updated