Batches

Batch management

Update Project Batches

post

https://imeritapi.ango.ai/v2https://us-api.ango.ai/v2https://in-api.ango.ai/v2https://testapi.ango.ai/v2

/batches/{projectId}

Updates batch definitions for a project

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

projectIdstringRequired

Project ID

Body

application/json

Responses

200

Batches updated successfully

application/json

statusstringOptionalExample: success

post/batches/{projectId}

HTTPcURLJavaScriptPython

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

{
  "batches": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "name": "Batch 1"
    }
  ]
}

200

Batches updated successfully

{
  "status": "success",
  "data": {
    "project": {
      "_id": "text",
      "name": "text",
      "description": "text",
      "type": "ango",
      "owner": "text",
      "organization": "text",
      "categorySchema": {
        "tools": [
          {
            "schemaId": "car-bbox-001",
            "title": "Car",
            "tool": "bounding-box",
            "required": false,
            "color": "#FF5733",
            "shortcutKey": "c",
            "classifications": []
          },
          {
            "schemaId": "person-polygon-002",
            "title": "Person",
            "tool": "polygon",
            "required": false,
            "color": "#33FF57",
            "shortcutKey": "p",
            "classifications": []
          }
        ],
        "classifications": [
          {
            "schemaId": "e4dd1c6f65a04d51b3ea66d23c92a321",
            "title": "Choice",
            "tool": "single-dropdown",
            "color": "#20549F",
            "required": false,
            "shortcutKey": "",
            "columnField": false,
            "frameSpecific": false,
            "showDropdown": false,
            "richText": false,
            "regex": null,
            "parentOptionId": null,
            "classifications": [],
            "treeOptions": [],
            "options": [
              {
                "schemaId": "793a5f9474b64bf5919d943b4cef9b65",
                "value": "First"
              },
              {
                "schemaId": "47e022c1cc9b41aa9a3d000c7bbc6524",
                "value": "Second"
              }
            ]
          }
        ],
        "relations": [
          {
            "schemaId": "e7b0db15cfa3bad2a824839",
            "tool": "one-to-one",
            "title": "Connected To",
            "required": false,
            "classifications": [],
            "multiple": false,
            "color": "#f44336",
            "shortcutKey": "1"
          },
          {
            "schemaId": "0e66cb4c8859ccc90103186",
            "tool": "group",
            "title": "Grouped With",
            "required": false,
            "classifications": [],
            "multiple": false,
            "color": "#03a9f4",
            "shortcutKey": "2"
          }
        ]
      },
      "stages": [
        {
          "id": "Label",
          "name": "Labeling",
          "type": "Label",
          "next": [
            "Review"
          ],
          "position": {
            "x": 300,
            "y": 50
          },
          "assignedTo": [
            "[e-mail]"
          ],
          "autoForward": false,
          "rememberAssignee": true
        }
      ],
      "assignedTo": [
        {
          "assignee": "text",
          "role": "Manager"
        }
      ],
      "batches": [
        {
          "_id": "507f1f77bcf86cd799439011",
          "name": "Batch 1"
        }
      ],
      "queueVersion": 2,
      "assetCount": 1,
      "benchmarkEnabled": true,
      "benchmarkRatio": 1,
      "instructions": "text",
      "ocrLanguage": "text",
      "idleTimeout": 1,
      "projectPlugins": {},
      "pluginPresets": [
        {}
      ],
      "errorCodesEnabled": true,
      "errorSchema": {},
      "exportStorageId": "text",
      "exportStorageBucket": "text",
      "exportStoragePath": "text",
      "exportStorageEnabled": true,
      "taskSkipEnabled": true,
      "unassignSkippedTask": true,
      "gcSyncEnabled": true,
      "deleted": true,
      "createdAt": "2026-08-08T16:09:58.547Z",
      "updatedAt": "2026-08-08T16:09:58.547Z"
    }
  }
}