Tasks

Task and annotation management

Get Project Tasks

get

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/project/{projectId}/tasks

Retrieves all tasks for a specific project with optional filtering

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

projectIdstringRequired

Project ID

Query parameters

pageinteger · min: 1Optional

Page number (1-indexed)

Default: 1

limitinteger · min: 1 · max: 100Optional

Items per page (max 100)

Default: 10

filtersstringOptional

JSON stringified filter object

statusstringOptional

Filter by task status

stagestringOptional

Filter by stage ID

assigneestringOptional

Filter by assignee email

batchesstringOptional

Filter by batch names (comma-separated)

Responses

200

Tasks retrieved successfully

application/json

get

/project/{projectId}/tasks

curlJavaScriptPython

curl -X GET "https://imeritapi.ango.ai/v2/project/YOUR_PROJECT_ID/tasks?page=1&limit=10&status=Completed&stage=Label" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

200

Tasks retrieved successfully

{
  "status": "success",
  "data": {
    "tasks": [
      {
        "_id": "text",
        "project": "text",
        "asset": "text",
        "stage": "text",
        "status": "text",
        "assignee": "text",
        "externalId": "text",
        "batches": [
          "text"
        ],
        "priority": 1,
        "answer": {},
        "createdAt": "2026-01-18T15:53:50.711Z",
        "completedAt": "2026-01-18T15:53:50.711Z",
        "duration": 1
      }
    ],
    "total": 1
  }
}

Requeue Tasks

post

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/project/{projectId}/requeueTasks

Move tasks from one stage to another based on filter criteria

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

projectIdstringRequired

Project ID

Body

application/json

toStageIdstringRequired

Destination stage ID

Responses

200

Tasks requeued successfully

application/json

400

Bad request - validation error

application/json

post

/project/{projectId}/requeueTasks

curlJavaScriptPython

curl -X POST "https://imeritapi.ango.ai/v2/project/YOUR_PROJECT_ID/requeueTasks" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "toStageId": "stageId1",
    "filters": {
      "fromStageIds": ["stageId2", "stageId3"],
      "batches": ["batchId1", "batchId2"]
    },
    "options": {
      "removeAnnotations": false,
      "removeAssignee": true,
      "removeStageHistory": false
    }
  }'

{
  "status": "success",
  "data": {
    "modifiedCount": {
      "modified": 1,
      "toStageId": "text"
    }
  }
}

Update Task Priority

post

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/project/{projectId}/updatePriority

Update priority for multiple tasks based on filter criteria

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

projectIdstringRequired

Project ID

Body

application/json

prioritynumber · min: -1000 · max: 1000Required

Priority value (-1000 to 1000)

optionsobjectOptional

Responses

200

Priority updated successfully

application/json

400

Bad request - validation error

application/json

post

/project/{projectId}/updatePriority

HTTPcURLJavaScriptPython

POST /v2/project/{projectId}/updatePriority HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 144

{
  "priority": 1,
  "filters": {
    "taskIds": [
      "text"
    ],
    "externalIds": [
      "text"
    ],
    "assetIds": [
      "text"
    ],
    "fromStageIds": [
      "text"
    ],
    "batches": [
      "text"
    ]
  },
  "options": {}
}

{
  "status": "success",
  "data": {
    "result": {
      "modifiedCount": 1,
      "priority": 1
    }
  }
}

Get Task Details

get

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/task/{taskId}

Retrieves detailed information about a specific task

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

taskIdstringRequired

Task ID

Responses

200

Task retrieved successfully

application/json

404

Resource not found

application/json

get

/task/{taskId}

curlJavaScriptPython

curl -X GET "https://imeritapi.ango.ai/v2/task/YOUR_TASK_ID" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "task": {
      "_id": "text",
      "project": "text",
      "asset": "text",
      "stage": "text",
      "status": "text",
      "assignee": "text",
      "externalId": "text",
      "batches": [
        "text"
      ],
      "priority": 1,
      "answer": {},
      "createdAt": "2026-01-18T15:53:50.711Z",
      "completedAt": "2026-01-18T15:53:50.711Z",
      "duration": 1
    }
  }
}

Get Task History

get

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/task/{taskId}/history

Retrieves the complete history of changes for a task

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

taskIdstringRequired

Task ID

Query parameters

pageinteger · min: 1Optional

Page number (1-indexed)

Default: 1

limitinteger · min: 1 · max: 100Optional

Items per page (max 100)

Default: 10

Responses

200

Task history retrieved successfully

application/json

get

/task/{taskId}/history

HTTPcURLJavaScriptPython

GET /v2/task/{taskId}/history HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Accept: */*

200

Task history retrieved successfully

{
  "status": "success",
  "data": {
    "taskHistory": [
      {
        "_id": "text",
        "task": "text",
        "user": "text",
        "action": "text",
        "answer": {},
        "createdAt": "2026-01-18T15:53:50.711Z"
      }
    ]
  }
}

Get Task History Entry

get

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/taskHistory/{taskHistoryId}

Retrieves a specific task history entry by ID

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

taskHistoryIdstringRequired

Task history entry ID

Responses

200

Task history entry retrieved successfully

application/json

get

/taskHistory/{taskHistoryId}

HTTPcURLJavaScriptPython

GET /v2/taskHistory/{taskHistoryId} HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Accept: */*

200

Task history entry retrieved successfully

{
  "status": "success",
  "data": {
    "taskHistory": {
      "_id": "text",
      "task": "text",
      "user": "text",
      "action": "text",
      "answer": {},
      "createdAt": "2026-01-18T15:53:50.711Z"
    }
  }
}

Assign Tasks to User

post

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/task/assign

Assigns one or more tasks to a specific user at a specific stage

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Body

application/json

userstringRequired

User email to assign to

projectstringRequired

Project ID

tasksstring[]Required

Array of task IDs

stagestringRequired

Stage ID

Responses

200

Tasks assigned successfully

application/json

400

Bad request - validation error

application/json

post

/task/assign

curlJavaScriptPython

curl -X POST "https://imeritapi.ango.ai/v2/task/assign" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": "[email protected]",
    "project": "YOUR_PROJECT_ID",
    "tasks": ["YOUR_TASK_ID_1", "YOUR_TASK_ID_2"],
    "stage": "Label"
  }'

{
  "status": "success",
  "data": {
    "task": {
      "updatedCount": 1,
      "assignedTasks": {
        "count": 1
      },
      "message": "text"
    }
  }
}

Submit Review Decision

post

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/review/{taskId}

Submits a review decision (accept/reject) for a task in a Review stage.

This endpoint is used to submit review decisions for tasks that are currently in a Review stage of the workflow. When a review decision is submitted, the task automatically advances to the next stage in the workflow.

Important: The task must be in a Review stage. Use /annotate/{taskId} for Label stages.

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

taskIdstringRequired

Task ID

Body

application/json

reviewStatusstring · enumRequired

Review decision for the task.

• Accepted: Approve the task and move it to the next stage
• Rejected: Reject the task (typically sends it back for correction)

Possible values:

answerobjectOptional

Optional annotation modifications (structure depends on project categorySchema)

durationnumberOptional

Time spent reviewing in seconds

idleDurationnumberOptional

Idle time during review in seconds

blurDurationnumberOptional

Time window was blurred/unfocused in seconds

Responses

200

Review submitted successfully

application/json

400

Bad request - task not in Review stage or invalid reviewStatus

application/json

404

Task or stage not found

application/json

post

/review/{taskId}

curl – Accept the Taskcurl – Reject the TaskJavaScript – Accept the TaskPython – Accept the Task

curl -X POST "https://imeritapi.ango.ai/v2/review/YOUR_TASK_ID" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reviewStatus": "Accepted"
  }'

{
  "status": "success",
  "data": {
    "label": {
      "_id": "text",
      "project": "text",
      "asset": "text",
      "stage": "text",
      "status": "text",
      "assignee": "text",
      "externalId": "text",
      "batches": [
        "text"
      ],
      "priority": 1,
      "answer": {},
      "createdAt": "2026-01-18T15:53:50.711Z",
      "completedAt": "2026-01-18T15:53:50.711Z",
      "duration": 1
    }
  }
}