Issues

Issue tracking and reporting

Get Issues

get

/issues

Retrieves issues with optional filtering

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Query parameters

pageinteger · min: 1Optional

Page number (1-indexed)

Default: 1

limitinteger · min: 1 · max: 100Optional

Items per page (max 100)

Default: 10

projectstringOptional

Filter by project ID

statusstring · enumOptional

Filter by issue status

Possible values:

assigneestringOptional

Filter by assignee email

createdBystringOptional

Filter by creator email

Responses

201

Issues retrieved successfully

application/json

get

/issues

curl -X GET "https://imeritapi.ango.ai/v2/issues?project=507f1f77bcf86cd799439011&status=Open&page=1&limit=10" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

201

Issues retrieved successfully

{
  "status": "success",
  "data": {
    "issue": [
      {
        "_id": "text",
        "title": "text",
        "content": "text",
        "project": "text",
        "asset": "text",
        "labelTask": "text",
        "status": "Open",
        "createdBy": "text",
        "assignee": "text",
        "errorType": "text",
        "errorCode": "text",
        "position": "text",
        "points": [
          {}
        ],
        "contentMentions": [
          {
            "userEmail": "text",
            "userName": "text"
          }
        ],
        "comments": [
          {
            "_id": "text",
            "content": "text",
            "createdBy": "text",
            "createdAt": "2025-12-06T20:33:31.552Z",
            "updatedAt": "2025-12-06T20:33:31.552Z",
            "contentMentions": [
              {
                "userEmail": "text",
                "userName": "text"
              }
            ]
          }
        ],
        "errorCodes": [
          {
            "category": "text",
            "name": "text",
            "key": "text"
          }
        ],
        "pctDetails": {
          "attribute": "31e3940a3d60b6a7f692393",
          "class": "de20f91fe9ae313e4d24958",
          "frame": 1,
          "endInputFrame": 1,
          "instance": -1,
          "severity": 2,
          "referenceIndex": -1,
          "marker": {
            "type": "Marker 3D",
            "value": {
              "geometry": {
                "position": {
                  "x": 5.75,
                  "y": -4.68,
                  "z": 0.6
                },
                "rotation": {
                  "x": 0,
                  "y": 0,
                  "z": 0
                },
                "boxSize": {
                  "x": 21.88,
                  "y": 21.88,
                  "z": 21.88
                }
              }
            }
          }
        },
        "resolvedBy": "text",
        "resolvedAt": "2025-12-06T20:33:31.552Z",
        "updatedBy": "text",
        "updatedAt": "2025-12-06T20:33:31.552Z",
        "createdAt": "2025-12-06T20:33:31.552Z"
      }
    ]
  }
}

Create Issue

post

/issues

Creates a new issue for a task

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Body

labelTaskstringRequired

Task ID to create issue for

titlestringOptional

contentstringOptional

positionstringOptional

pointsobject[]Optional

errorTypestringOptional

errorCodestringOptional

Responses

201

Issue created successfully

application/json

400

Bad request - validation error

application/json

post

/issues

POST /v2/issues HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 509

{
  "labelTask": "text",
  "title": "text",
  "content": "text",
  "contentMentions": [
    {
      "userEmail": "text",
      "userName": "text"
    }
  ],
  "position": "text",
  "points": [
    {}
  ],
  "errorType": "text",
  "errorCode": "text",
  "pctDetails": {
    "attribute": "31e3940a3d60b6a7f692393",
    "class": "de20f91fe9ae313e4d24958",
    "frame": 1,
    "endInputFrame": 1,
    "instance": -1,
    "severity": 2,
    "referenceIndex": -1,
    "marker": {
      "type": "Marker 3D",
      "value": {
        "geometry": {
          "position": {
            "x": 5.75,
            "y": -4.68,
            "z": 0.6
          },
          "rotation": {
            "x": 0,
            "y": 0,
            "z": 0
          },
          "boxSize": {
            "x": 21.88,
            "y": 21.88,
            "z": 21.88
          }
        }
      }
    }
  }
}

{
  "status": "success",
  "data": {
    "issue": {
      "_id": "text",
      "title": "text",
      "content": "text",
      "project": "text",
      "asset": "text",
      "labelTask": "text",
      "status": "Open",
      "createdBy": "text",
      "assignee": "text",
      "errorType": "text",
      "errorCode": "text",
      "position": "text",
      "points": [
        {}
      ],
      "contentMentions": [
        {
          "userEmail": "text",
          "userName": "text"
        }
      ],
      "comments": [
        {
          "_id": "text",
          "content": "text",
          "createdBy": "text",
          "createdAt": "2025-12-06T20:33:31.552Z",
          "updatedAt": "2025-12-06T20:33:31.552Z",
          "contentMentions": [
            {
              "userEmail": "text",
              "userName": "text"
            }
          ]
        }
      ],
      "errorCodes": [
        {
          "category": "text",
          "name": "text",
          "key": "text"
        }
      ],
      "pctDetails": {
        "attribute": "31e3940a3d60b6a7f692393",
        "class": "de20f91fe9ae313e4d24958",
        "frame": 1,
        "endInputFrame": 1,
        "instance": -1,
        "severity": 2,
        "referenceIndex": -1,
        "marker": {
          "type": "Marker 3D",
          "value": {
            "geometry": {
              "position": {
                "x": 5.75,
                "y": -4.68,
                "z": 0.6
              },
              "rotation": {
                "x": 0,
                "y": 0,
                "z": 0
              },
              "boxSize": {
                "x": 21.88,
                "y": 21.88,
                "z": 21.88
              }
            }
          }
        }
      },
      "resolvedBy": "text",
      "resolvedAt": "2025-12-06T20:33:31.552Z",
      "updatedBy": "text",
      "updatedAt": "2025-12-06T20:33:31.552Z",
      "createdAt": "2025-12-06T20:33:31.552Z"
    }
  }
}

Update Issue

post

/issues/{issueId}

Updates an existing issue. All fields are optional - only provided fields will be updated.

Updatable fields:

content: Update the issue description/content
status: Change status to "Open" or "Resolved"
pctDetails: Update PCT-specific details (for PCT issues)
errorCodes: Update error codes associated with the issue

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

issueIdstringRequired

Issue ID

Body

Request body for updating an issue. All fields are optional.

contentstringOptional

Updated issue content/description

statusstring · enumOptional

Issue status (Open or Resolved)

Possible values:

Responses

201

Issue updated successfully

application/json

400

Bad request - validation error

application/json

404

Resource not found

application/json

post

/issues/{issueId}

curl -X POST "https://imeritapi.ango.ai/v2/issues/507f1f77bcf86cd799439011" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "Resolved",
    "content": "Issue has been fixed"
  }'

{
  "status": "success",
  "data": {
    "issue": {
      "_id": "text",
      "title": "text",
      "content": "text",
      "project": "text",
      "asset": "text",
      "labelTask": "text",
      "status": "Open",
      "createdBy": "text",
      "assignee": "text",
      "errorType": "text",
      "errorCode": "text",
      "position": "text",
      "points": [
        {}
      ],
      "contentMentions": [
        {
          "userEmail": "text",
          "userName": "text"
        }
      ],
      "comments": [
        {
          "_id": "text",
          "content": "text",
          "createdBy": "text",
          "createdAt": "2025-12-06T20:33:31.552Z",
          "updatedAt": "2025-12-06T20:33:31.552Z",
          "contentMentions": [
            {
              "userEmail": "text",
              "userName": "text"
            }
          ]
        }
      ],
      "errorCodes": [
        {
          "category": "text",
          "name": "text",
          "key": "text"
        }
      ],
      "pctDetails": {
        "attribute": "31e3940a3d60b6a7f692393",
        "class": "de20f91fe9ae313e4d24958",
        "frame": 1,
        "endInputFrame": 1,
        "instance": -1,
        "severity": 2,
        "referenceIndex": -1,
        "marker": {
          "type": "Marker 3D",
          "value": {
            "geometry": {
              "position": {
                "x": 5.75,
                "y": -4.68,
                "z": 0.6
              },
              "rotation": {
                "x": 0,
                "y": 0,
                "z": 0
              },
              "boxSize": {
                "x": 21.88,
                "y": 21.88,
                "z": 21.88
              }
            }
          }
        }
      },
      "resolvedBy": "text",
      "resolvedAt": "2025-12-06T20:33:31.552Z",
      "updatedBy": "text",
      "updatedAt": "2025-12-06T20:33:31.552Z",
      "createdAt": "2025-12-06T20:33:31.552Z"
    }
  }
}

Delete Issue

delete

/issues/{issueId}

Deletes an existing issue

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

issueIdstringRequired

Issue ID

Responses

201

Issue deleted successfully

application/json

delete

/issues/{issueId}

DELETE /v2/issues/{issueId} HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Accept: */*

201

Issue deleted successfully

{
  "status": "success",
  "data": {
    "issue": {
      "_id": "text",
      "title": "text",
      "content": "text",
      "project": "text",
      "asset": "text",
      "labelTask": "text",
      "status": "Open",
      "createdBy": "text",
      "assignee": "text",
      "errorType": "text",
      "errorCode": "text",
      "position": "text",
      "points": [
        {}
      ],
      "contentMentions": [
        {
          "userEmail": "text",
          "userName": "text"
        }
      ],
      "comments": [
        {
          "_id": "text",
          "content": "text",
          "createdBy": "text",
          "createdAt": "2025-12-06T20:33:31.552Z",
          "updatedAt": "2025-12-06T20:33:31.552Z",
          "contentMentions": [
            {
              "userEmail": "text",
              "userName": "text"
            }
          ]
        }
      ],
      "errorCodes": [
        {
          "category": "text",
          "name": "text",
          "key": "text"
        }
      ],
      "pctDetails": {
        "attribute": "31e3940a3d60b6a7f692393",
        "class": "de20f91fe9ae313e4d24958",
        "frame": 1,
        "endInputFrame": 1,
        "instance": -1,
        "severity": 2,
        "referenceIndex": -1,
        "marker": {
          "type": "Marker 3D",
          "value": {
            "geometry": {
              "position": {
                "x": 5.75,
                "y": -4.68,
                "z": 0.6
              },
              "rotation": {
                "x": 0,
                "y": 0,
                "z": 0
              },
              "boxSize": {
                "x": 21.88,
                "y": 21.88,
                "z": 21.88
              }
            }
          }
        }
      },
      "resolvedBy": "text",
      "resolvedAt": "2025-12-06T20:33:31.552Z",
      "updatedBy": "text",
      "updatedAt": "2025-12-06T20:33:31.552Z",
      "createdAt": "2025-12-06T20:33:31.552Z"
    }
  }
}

Add Comment to Issue

post

/issues/{issueId}/comment

Adds a new comment to an existing issue.

Comments are used for discussion and collaboration on issues. Each comment records the author and timestamp automatically.

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

issueIdstringRequired

Issue ID

Body

contentstringRequired

The comment text content

Responses

201

Comment added successfully

application/json

400

Bad request - validation error

application/json

404

Resource not found

application/json

post

/issues/{issueId}/comment

curl -X POST "https://imeritapi.ango.ai/v2/issues/507f1f77bcf86cd799439011/comment" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "This needs to be reviewed by the team"
  }'

{
  "status": "success",
  "data": {
    "issue": {
      "_id": "text",
      "title": "text",
      "content": "text",
      "project": "text",
      "asset": "text",
      "labelTask": "text",
      "status": "Open",
      "createdBy": "text",
      "assignee": "text",
      "errorType": "text",
      "errorCode": "text",
      "position": "text",
      "points": [
        {}
      ],
      "contentMentions": [
        {
          "userEmail": "text",
          "userName": "text"
        }
      ],
      "comments": [
        {
          "_id": "text",
          "content": "text",
          "createdBy": "text",
          "createdAt": "2025-12-06T20:33:31.552Z",
          "updatedAt": "2025-12-06T20:33:31.552Z",
          "contentMentions": [
            {
              "userEmail": "text",
              "userName": "text"
            }
          ]
        }
      ],
      "errorCodes": [
        {
          "category": "text",
          "name": "text",
          "key": "text"
        }
      ],
      "pctDetails": {
        "attribute": "31e3940a3d60b6a7f692393",
        "class": "de20f91fe9ae313e4d24958",
        "frame": 1,
        "endInputFrame": 1,
        "instance": -1,
        "severity": 2,
        "referenceIndex": -1,
        "marker": {
          "type": "Marker 3D",
          "value": {
            "geometry": {
              "position": {
                "x": 5.75,
                "y": -4.68,
                "z": 0.6
              },
              "rotation": {
                "x": 0,
                "y": 0,
                "z": 0
              },
              "boxSize": {
                "x": 21.88,
                "y": 21.88,
                "z": 21.88
              }
            }
          }
        }
      },
      "resolvedBy": "text",
      "resolvedAt": "2025-12-06T20:33:31.552Z",
      "updatedBy": "text",
      "updatedAt": "2025-12-06T20:33:31.552Z",
      "createdAt": "2025-12-06T20:33:31.552Z"
    }
  }
}

Last updated 1 day ago