Get daily error counts for an agent

curl --request GET \
  --url "http://localhost:8002/api/v1/agent/error-count/?start_date=2026-03-20&end_date=2026-03-26" \
  --header "X-OTAS-USER-TOKEN: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  --header "X-OTAS-AGENT-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  --header "X-OTAS-PROJECT-ID: 3f6e2b10-8c1a-4d55-b9d4-0a2e3c7f1234"

{
  "status": 1,
  "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "project_id": "3f6e2b10-8c1a-4d55-b9d4-0a2e3c7f1234",
  "data": [
    {
      "date": "2026-03-22",
      "error_count": 2
    },
    {
      "date": "2026-03-24",
      "error_count": 7
    },
    {
      "date": "2026-03-26",
      "error_count": 3
    }
  ]
}

{
  "status": 0,
  "status_description": "start_date and end_date are required"
}

{
  "status": 0,
  "status_description": "forbidden"
}

curl --request GET \
  --url "http://localhost:8002/api/v1/agent/error-count/?start_date=2026-03-20&end_date=2026-03-26" \
  --header "X-OTAS-USER-TOKEN: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  --header "X-OTAS-AGENT-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  --header "X-OTAS-PROJECT-ID: 3f6e2b10-8c1a-4d55-b9d4-0a2e3c7f1234"

{
  "status": 1,
  "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "project_id": "3f6e2b10-8c1a-4d55-b9d4-0a2e3c7f1234",
  "data": [
    {
      "date": "2026-03-22",
      "error_count": 2
    },
    {
      "date": "2026-03-24",
      "error_count": 7
    },
    {
      "date": "2026-03-26",
      "error_count": 3
    }
  ]
}

{
  "status": 0,
  "status_description": "start_date and end_date are required"
}

{
  "status": 0,
  "status_description": "forbidden"
}

The error-count endpoint returns the number of events per day where the error field is non-null and non-empty. Use this to monitor your agent’s failure rate over time and quickly spot days with elevated error activity. Combined with the path-timeseries endpoint, you can calculate the error rate per path to identify which specific endpoints are most prone to failures.

To calculate error rate per path, divide each day’s error_count from this endpoint by the corresponding day’s total event count from the path-timeseries endpoint.

Request

string

required

JWT identifying the authenticated user.

string

required

UUID of the agent to retrieve error data for.

string

required

UUID of the project the agent belongs to.

Query parameters

string

required

Start of the date range, inclusive. Must be in YYYY-MM-DD format.

string

required

End of the date range, inclusive. Must be in YYYY-MM-DD format and must not be before start_date.

Response

number

required

1 on success.

string

required

The agent UUID from the request headers.

string

required

The project UUID from the request headers.

object[]

required

Daily error count entries, ordered by date ascending.

Show data point properties

string

required

Date in YYYY-MM-DD format.

number

required

Number of events on this date where error is not null and not an empty string.

Only dates with at least one error event are included. Days where every event succeeded (i.e. error is null or "" for all events) are omitted from the response. An event is counted as an error when error IS NOT NULL AND error != ''.

Errors

HTTP	`status_description`	Meaning
400	`missing_dates`	`start_date` or `end_date` query parameter was not provided.
400	`invalid_date_format`	One or both dates are not in `YYYY-MM-DD` format.
400	`invalid_date_range`	`start_date` is after `end_date`.
401	`missing_user_token`	`X-OTAS-USER-TOKEN` header was not provided.
400	`missing_agent_id`	`X-OTAS-AGENT-ID` header was not provided.
400	`missing_project_id`	`X-OTAS-PROJECT-ID` header was not provided.
403	`forbidden`	The authenticated user does not have access to the specified project.
404	`agent_not_found`	No active agent matches the provided agent ID.
503	`auth_service_timeout`	The UASAM auth service did not respond within the timeout window.
503	`auth_service_error`	The UASAM auth service is unreachable.
500	`server_error`	An unexpected internal error occurred.

curl --request GET \
  --url "http://localhost:8002/api/v1/agent/error-count/?start_date=2026-03-20&end_date=2026-03-26" \
  --header "X-OTAS-USER-TOKEN: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  --header "X-OTAS-AGENT-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  --header "X-OTAS-PROJECT-ID: 3f6e2b10-8c1a-4d55-b9d4-0a2e3c7f1234"

{
  "status": 1,
  "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "project_id": "3f6e2b10-8c1a-4d55-b9d4-0a2e3c7f1234",
  "data": [
    {
      "date": "2026-03-22",
      "error_count": 2
    },
    {
      "date": "2026-03-24",
      "error_count": 7
    },
    {
      "date": "2026-03-26",
      "error_count": 3
    }
  ]
}

{
  "status": 0,
  "status_description": "start_date and end_date are required"
}

{
  "status": 0,
  "status_description": "forbidden"
}

UASAM — Users & Auth

UASAM — Projects & Keys

UASAM — Agents

Brain — Event Capture

Brain — Analytics

Get daily error counts for an agent

Request

Query parameters

Response

Errors

​Request

​Query parameters

​Response

​Errors

Request

Query parameters

Response

Errors