Import/Export
Bulk data import and export
Submits annotation answer for a task
Task ID
Set to 'true' if annotation from plugin
Annotation answer object (structure depends on project categorySchema)
Annotation submitted successfully
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"
}
]
}
}'
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
}
}
}Imports attachments and associates them with assets
Attachments imported successfully
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"
}
]
}'
Attachments imported successfully
{
"status": "success",
"data": {
"project": {
"attachmentsImported": 1,
"assetsUpdated": 1
}
}
}Imports pre-labeled data into a project
Labels imported successfully
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": []
}
}
]
}'
Labels imported successfully
{
"status": "success",
"data": {
"project": "50 / 50 tasks are labeled."
}
}Exports task data from projects in various formats
Project ID
507f1f77bcf86cd799439011Export format
jsonPossible values: Export type (task or issue)
taskPossible values: Filter by stages (JSON array string, e.g., ["Complete"])
["Complete"]Filter by batches (JSON array string, e.g., ["Batch1"])
["Batch1"]Send export download link via email
falsePossible values: Do not send notifications about export
falsePossible values: Include asset metadata in export
falsePossible values: Include task history (all state changes)
falsePossible values: Include only key frames for video annotations
falsePossible values: Include idle and blur duration statistics
falsePossible values: Filter by update date (JSON object, e.g., {"$gt":"2020-08-19T07:37:15.000000Z","$lt":"2020-08-26T07:37:15.000000Z"})
{"$gt":"2020-08-19T07:37:15.000000Z","$lt":"2020-08-26T07:37:15.000000Z"}Filter by creation date (JSON object, e.g., {"$gt":"2020-07-27T07:37:15.000000Z","$lt":"2020-08-26T07:37:15.000000Z"})
{"$gt":"2020-07-27T07:37:15.000000Z","$lt":"2020-08-26T07:37:15.000000Z"}Export prepared successfully
curl -X GET "https://imeritapi.ango.ai/v2/export?project=507f1f77bcf86cd799439011&format=json" \
-H "apikey: YOUR_API_KEY"
Export prepared successfully
{
"status": "success",
"data": {
"exportPath": "https://bucket.s3.amazonaws.com/exports/export-2025-01-17.json"
}
}Last updated