# Import/Export

Bulk data import and export

## Submit Annotation

> Submits annotation answer for a task

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Import/Export","description":"Bulk data import and export"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"schemas":{"AnnotateRequest":{"type":"object","required":["answer"],"properties":{"answer":{"type":"object","description":"Annotation answer object (structure depends on project categorySchema)"}}},"LabelResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"label":{"$ref":"#/components/schemas/LabelTask"}}}}},"LabelTask":{"type":"object","properties":{"_id":{"type":"string"},"project":{"type":"string"},"asset":{"type":"string"},"stage":{"type":"string"},"status":{"type":"string"},"assignee":{"type":"string"},"externalId":{"type":"string"},"batches":{"type":"array","items":{"type":"string"}},"priority":{"type":"number"},"answer":{"type":"object"},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"duration":{"type":"number","description":"Duration in seconds"}}}}},"paths":{"/annotate/{taskId}":{"post":{"tags":["Import/Export"],"summary":"Submit Annotation","description":"Submits annotation answer for a task","operationId":"annotateTask","parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"},"description":"Task ID"},{"name":"isPlugin","in":"query","schema":{"type":"string","enum":["true","false"]},"description":"Set to 'true' if annotation from plugin"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnotateRequest"}}}},"responses":{"200":{"description":"Annotation submitted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelResponse"}}}}}}}}}
```

## Import Attachments

> Imports attachments and associates them with assets

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Import/Export","description":"Bulk data import and export"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"schemas":{"ImportAttachmentsRequest":{"type":"object","required":["project","attachments"],"properties":{"project":{"type":"string"},"attachments":{"type":"array","items":{"type":"object","required":["attachmentUrl"],"properties":{"assetId":{"type":"string"},"externalId":{"type":"string"},"attachmentUrl":{"type":"string"},"attachmentType":{"type":"string"}}}}}},"ImportAttachmentsResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"project":{"type":"object","properties":{"attachmentsImported":{"type":"integer"},"assetsUpdated":{"type":"integer"}}}}}}}}},"paths":{"/attachments":{"post":{"tags":["Import/Export"],"summary":"Import Attachments","description":"Imports attachments and associates them with assets","operationId":"importAttachments","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportAttachmentsRequest"}}}},"responses":{"200":{"description":"Attachments imported successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportAttachmentsResponse"}}}}}}}}}
```

## Import Labels

> Imports pre-labeled data into a project

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Import/Export","description":"Bulk data import and export"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"schemas":{"ImportLabelsRequest":{"type":"object","required":["project","labels"],"properties":{"project":{"type":"string"},"labels":{"type":"array","items":{"type":"object","required":["answer"],"properties":{"assetId":{"type":"string"},"externalId":{"type":"string"},"answer":{"type":"object"},"status":{"type":"string"},"assignee":{"type":"string"}}}}}},"ImportLabelsResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"project":{"type":"string","description":"Success message indicating labeled task count"}}}}}}},"paths":{"/import/labels":{"post":{"tags":["Import/Export"],"summary":"Import Labels","description":"Imports pre-labeled data into a project","operationId":"importLabels","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportLabelsRequest"}}}},"responses":{"200":{"description":"Labels imported successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportLabelsResponse"}}}}}}}}}
```

## Export Tasks

> Exports task data from projects in various formats

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Import/Export","description":"Bulk data import and export"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"schemas":{"ExportResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"exportPath":{"type":"string"}}}}}}},"paths":{"/export":{"get":{"tags":["Import/Export"],"summary":"Export Tasks","description":"Exports task data from projects in various formats","operationId":"exportTasks","parameters":[{"name":"project","in":"query","required":true,"schema":{"type":"string"},"description":"Project ID"},{"name":"format","in":"query","schema":{"type":"string","enum":["json","split","ndjson"],"default":"json"},"description":"Export format"},{"name":"type","in":"query","schema":{"type":"string","enum":["task","issue"],"default":"task"},"description":"Export type (task or issue)"},{"name":"stage","in":"query","schema":{"type":"string"},"description":"Filter by stages (JSON array string, e.g., [\"Complete\"])"},{"name":"batches","in":"query","schema":{"type":"string"},"description":"Filter by batches (JSON array string, e.g., [\"Batch1\"])"},{"name":"sendEmail","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Send export download link via email"},{"name":"doNotNotify","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Do not send notifications about export"},{"name":"includeMetadata","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Include asset metadata in export"},{"name":"includeHistory","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Include task history (all state changes)"},{"name":"includeOnlyKeyFrames","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Include only key frames for video annotations"},{"name":"includeIdleBlurDurations","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Include idle and blur duration statistics"},{"name":"updatedAt","in":"query","schema":{"type":"string"},"description":"Filter by update date (JSON object, e.g., {\"$gt\":\"2020-08-19T07:37:15.000000Z\",\"$lt\":\"2020-08-26T07:37:15.000000Z\"})"},{"name":"createdAt","in":"query","schema":{"type":"string"},"description":"Filter by creation date (JSON object, e.g., {\"$gt\":\"2020-07-27T07:37:15.000000Z\",\"$lt\":\"2020-08-26T07:37:15.000000Z\"})"},{"name":"filters","in":"query","schema":{"type":"string"},"description":"MongoDB-style filter object for advanced task filtering (JSON string).\nSupports any MongoDB query operators on task fields.\nCommon use cases:\n- Filter by task IDs: {\"_id\": {\"$in\": [\"taskId1\", \"taskId2\"]}}\n- Filter by assignee: {\"assignee\": \"user@example.com\"}\n- Filter by external ID: {\"externalId\": {\"$regex\": \"^prefix_\"}}\n"}],"responses":{"200":{"description":"Export prepared successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportResponse"}}}}}}}}}
```