Import/Export

Bulk data import and export

Import attachments

post

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

Import labels

post

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."
  }
}

Export tasks

get

Exports task data from projects in various formats

Authorizations
Query parameters
projectstringRequired

Project ID

formatstring · enumOptional

Export format (json, split, or ndjson)

Possible values:
statusstringOptional

Filter by task status

batchesstringOptional

Filter by batches (comma-separated)

includeAssetsstring · enumOptional

Include asset URLs

Possible values:
includeHistorystring · enumOptional

Include task history

Possible values:
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"
  }
}

Export tasks (V3 format)

get

Exports task data using enhanced V3 format

Authorizations
Query parameters
projectstringRequired

Project ID

formatstring · enumOptional

Export format (json, split, or ndjson)

Possible values:
statusstringOptional

Filter by status

batchesstringOptional

Filter by batches

includeAssetsstring · enumOptional

Include assets

Possible values:
includeHistorystring · enumOptional

Include history

Possible values:
includeMetadatastring · enumOptional

Include metadata

Possible values:
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"
  }
}