Import/Export
Bulk data import and export
Imports attachments and associates them with assets
Authorizations
Body
projectstringRequired
Responses
200
Attachments imported successfully
application/json
post
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
}
}
}
Imports pre-labeled data into a project
Authorizations
Body
projectstringRequired
Responses
200
Labels imported successfully
application/json
post
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."
}
}
Exports task data from projects in various formats
Authorizations
Query parameters
projectstringRequired
Project ID
formatstring · enumOptionalPossible values:
Export format (json, split, or ndjson)
statusstringOptional
Filter by task status
batchesstringOptional
Filter by batches (comma-separated)
includeAssetsstring · enumOptionalPossible values:
Include asset URLs
includeHistorystring · enumOptionalPossible values:
Include task history
Responses
200
Export prepared successfully
application/json
get
curl -X GET "https://imeritapi.ango.ai/v2/export?project=507f1f77bcf86cd799439011&format=json&status=Completed&includeAssets=true&includeHistory=false" \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json"
200
Export prepared successfully
{
"status": "success",
"data": {
"exportPath": "https://bucket.s3.amazonaws.com/exports/export-2025-01-17.json"
}
}
Exports task data using enhanced V3 format
Authorizations
Query parameters
projectstringRequired
Project ID
formatstring · enumOptionalPossible values:
Export format (json, split, or ndjson)
statusstringOptional
Filter by status
batchesstringOptional
Filter by batches
includeAssetsstring · enumOptionalPossible values:
Include assets
includeHistorystring · enumOptionalPossible values:
Include history
includeMetadatastring · enumOptionalPossible values:
Include metadata
Responses
200
Export prepared successfully
application/json
get
GET /v2/exportV3?project=text HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Accept: */*
200
Export prepared successfully
{
"status": "success",
"data": {
"exportPath": "https://bucket.s3.amazonaws.com/exports/export-2025-01-17.json"
}
}