Skip to main content
POST
List Agent Executions
Use this API to paginate through an agent’s execution history without fetching each execution individually. Filter by agentId, documentId, organizationId, and/or status, page with pageSize + cursor, and control sort order with orderDirection.

Endpoint

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

Headers

string
required
Your API key.
string
required

Body

Params

object
required

Example Requests

List the most recent executions for an agent

Paginate to the next page

List failed executions for a document, oldest first

Response

result.items is an array of execution documents ordered by startedAt, each including status and a human-readable message, so you can enumerate prior runs without per-execution lookups. nextCursor and hasMore drive pagination: pass nextCursor back as cursor while hasMore is true. An empty items array is returned when no executions match.

Success Response

Failure Response