REST API Endpoints for Argus Issues

Issues are groups of error events that share the same fingerprint — a hash derived from the exception type and stack trace. When the same error occurs many times, Argus merges those occurrences into a single issue rather than creating duplicate entries. You interact with issues to track, triage, and resolve the errors in your projects.

Authentication

All issue endpoints require an active session. Requests without a valid session cookie return 401 Unauthorized.

List Issues

Return a paginated list of issues for a project, with optional filtering by status or severity level.

GET /api/v1/projects/:projectId/issues

Path Parameters

projectId

string

required

The ID of the project whose issues you want to list.

Query Parameters

Parameter	Type	Description	Default
`page`	integer	Page number to retrieve. Minimum `1`.	`1`
`limit`	integer	Number of issues per page. Range: `1`–`50`.	`10`
`status`	string	Filter by issue status: `UNRESOLVED`, `RESOLVED`, or `IGNORED`.	All statuses
`level`	string	Filter by severity: `FATAL`, `ERROR`, `WARNING`, `INFO`, `DEBUG`.	All levels

Invalid values for status or level are silently ignored and the filter is not applied.

Example Request

curl 'https://your-domain.com/api/v1/projects/clxk2m9ab0000qw8e3f7t1pz2/issues?status=UNRESOLVED&level=ERROR&page=1&limit=10' \
  -H 'Cookie: session=YOUR_SESSION_COOKIE'

Example Response

{
  "statusCode": 200,
  "status": "success",
  "message": "Issues fetched",
  "data": {
    "issues": [
      {
        "id": "clxk3a7bc0002qw8e4h9v3rb5",
        "projectId": "clxk2m9ab0000qw8e3f7t1pz2",
        "fingerprint": "TypeError-abc123",
        "title": "TypeError: Cannot read properties of undefined (reading 'id')",
        "culprit": "app.js in handleClick",
        "status": "UNRESOLVED",
        "level": "ERROR",
        "eventCount": 47,
        "firstSeen": "2024-07-01T09:12:00.000Z",
        "lastSeen": "2024-07-15T14:05:33.000Z",
        "createdAt": "2024-07-01T09:12:00.000Z",
        "updatedAt": "2024-07-15T14:05:33.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 1,
      "pages": 1
    }
  }
}

Response Fields

data.issues

array

Array of issue objects, ordered by lastSeen descending (most recently active first).

data.issues[].id

string

Unique identifier for the issue.

data.issues[].fingerprint

string

The hash used to group events into this issue.

data.issues[].title

string

Human-readable title derived from the exception type and message.

data.issues[].culprit

string

The source location (file and function) closest to the throw site. May be null.

data.issues[].status

string

Current triage status: UNRESOLVED, RESOLVED, or IGNORED.

data.issues[].level

string

Severity level: FATAL, ERROR, WARNING, INFO, or DEBUG.

data.issues[].eventCount

integer

Total number of events grouped into this issue.

data.issues[].firstSeen

string

ISO 8601 timestamp of when this issue was first detected.

data.issues[].lastSeen

string

ISO 8601 timestamp of the most recent event for this issue.

data.pagination

object

Pagination metadata: page, limit, total (total matching issues), and pages (total page count).

Get an Issue

Retrieve full detail for a single issue, including its 10 most recent events.

GET /api/v1/projects/:projectId/issues/:id

Path Parameters

projectId

string

required

The ID of the project the issue belongs to.

string

required

The issue’s unique ID.

Example Request

curl https://your-domain.com/api/v1/projects/clxk2m9ab0000qw8e3f7t1pz2/issues/clxk3a7bc0002qw8e4h9v3rb5 \
  -H 'Cookie: session=YOUR_SESSION_COOKIE'

Example Response

{
  "statusCode": 200,
  "status": "success",
  "message": "Issue fetched",
  "data": {
    "id": "clxk3a7bc0002qw8e4h9v3rb5",
    "projectId": "clxk2m9ab0000qw8e3f7t1pz2",
    "fingerprint": "TypeError-abc123",
    "title": "TypeError: Cannot read properties of undefined (reading 'id')",
    "culprit": "app.js in handleClick",
    "status": "UNRESOLVED",
    "level": "ERROR",
    "eventCount": 47,
    "firstSeen": "2024-07-01T09:12:00.000Z",
    "lastSeen": "2024-07-15T14:05:33.000Z",
    "createdAt": "2024-07-01T09:12:00.000Z",
    "updatedAt": "2024-07-15T14:05:33.000Z",
    "events": [
      {
        "id": "clxk4b8cd0003qw8e5i0w4sc6",
        "issueId": "clxk3a7bc0002qw8e4h9v3rb5",
        "projectId": "clxk2m9ab0000qw8e3f7t1pz2",
        "level": "ERROR",
        "message": "Cannot read properties of undefined (reading 'id')",
        "timestamp": "2024-07-15T14:05:33.000Z",
        "receivedAt": "2024-07-15T14:05:34.123Z"
      }
    ]
  }
}

Update Issue Status

Change the triage status of an issue to UNRESOLVED, RESOLVED, or IGNORED.

PATCH /api/v1/projects/:projectId/issues/:id

Path Parameters

projectId

string

required

The ID of the project the issue belongs to.

string

required

The issue’s unique ID.

Request Body

status

string

required

The new status for the issue. Must be one of: UNRESOLVED, RESOLVED, IGNORED.

Example Request

curl -X PATCH https://your-domain.com/api/v1/projects/clxk2m9ab0000qw8e3f7t1pz2/issues/clxk3a7bc0002qw8e4h9v3rb5 \
  -H 'Content-Type: application/json' \
  -H 'Cookie: session=YOUR_SESSION_COOKIE' \
  -d '{ "status": "RESOLVED" }'

Example Response

{
  "statusCode": 200,
  "status": "success",
  "message": "Issue status updated",
  "data": {
    "id": "clxk3a7bc0002qw8e4h9v3rb5",
    "projectId": "clxk2m9ab0000qw8e3f7t1pz2",
    "fingerprint": "TypeError-abc123",
    "title": "TypeError: Cannot read properties of undefined (reading 'id')",
    "culprit": "app.js in handleClick",
    "status": "RESOLVED",
    "level": "ERROR",
    "eventCount": 47,
    "firstSeen": "2024-07-01T09:12:00.000Z",
    "lastSeen": "2024-07-15T14:05:33.000Z",
    "updatedAt": "2024-07-15T15:00:00.000Z"
  }
}

Response Codes

Status	Meaning
`200`	Request succeeded.
`400`	Invalid `status` value in the request body.
`401`	Not authenticated — no valid session.
`404`	Issue not found in the specified project.

​Authentication

​List Issues

​Path Parameters

​Query Parameters

​Example Request

​Example Response

​Response Fields

​Get an Issue

​Path Parameters

​Example Request

​Example Response

​Update Issue Status

​Path Parameters

​Request Body

​Example Request

​Example Response

​Response Codes

Authentication

List Issues

Path Parameters

Query Parameters

Example Request

Example Response

Response Fields

Get an Issue

Path Parameters

Example Request

Example Response

Update Issue Status

Path Parameters

Request Body

Example Request

Example Response

Response Codes