Skip to main content
POST
List Checks
Use this API to list a project’s checks, most severe first. Each row carries the check’s counts, score impact, state and owner. Filter by agent, severity, owner or state.

Endpoint

POST https://api.velt.dev/v2/agents/checks/list

Headers

string
required
Your API key.
string
required

Body

Params

object
required
The schema uses .strict(): unknown fields, in data or in filters, are rejected.

Example Requests

1. List every check

2. List the failing critical checks

Response

Success Response

Failure Response

Errors: INVALID_ARGUMENT (a body outside the schema: a missing organizationId or documentId, a filters value outside its list, or an unknown field) / NOT_FOUND with CHECKS_WORKSPACE_NOT_FOUND (the workspace has no store database).