Executions

List Executions

Changed on

List execution records with optional filters.

get/executions

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /executions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL /authorize, token URL /oauth/token)

Query parameters

toolkit_idstring nullable

Legacy: only return executions mediated by this toolkit.

Example:tk_6968b3981ec22d56dbbc91e8
trace_idstring nullable

Only return executions with this trace ID.

Example:4bf92f3577b34da6a3ce929d0e0e4736
statusstring[] nullable

Only return executions with one of these terminal statuses (completed or failed); repeat the parameter for several.

[
  "completed",
  "failed"
]
fromstring date-time nullable

Only return executions started at or after this time (RFC 3339).

Example:2026-01-01T00:00:00Z
tostring date-time nullable

Only return executions started before this time (RFC 3339).

Example:2026-01-31T23:59:59Z
apistring nullable

Only return executions of this API, given as vendor[:name[:version]].

Example:stripe.com:stripe:2024-04-10
actor_idstring nullable

Only return executions run by this actor.

Example:agnt_6968b3984d1c238dbe7e2e29
originstring nullable

Only return executions initiated from this surface, e.g. api or mcp.

Example:dashboard
cursorstring nullable

Opaque cursor from a previous page's next_cursor; omit for the first page.

Example:eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0=
limitinteger

Maximum number of execution records to return (1-100, default 25).

Example:25

Response

Successful Response

has_moreboolean required

Whether more results exist after this page.

next_cursorstring nullable

Cursor for the next page; null when there are no more results.

Example response

{
  "data": [
    {
      "_links": {
        "self": "https://jentic.example.com/executions/exec_6968b3982706c619fe73f0cf"
      },
      "actor_id": "agnt_6968b3984d1c238dbe7e2e29",
      "actor_type": "agent",
      "api": {
        "host": "api.stripe.com",
        "name": "stripe",
        "vendor": "stripe.com",
        "version": "2024-04-10"
      },
      "created_at": "2026-01-15T09:30:00Z",
      "credential_id": "cred_6968b39855d91a3561684b32",
      "credential_name": "Stripe production key",
      "duration_ms": 342,
      "error": "Upstream returned HTTP 502 Bad Gateway",
      "execution_id": "exec_6968b3982706c619fe73f0cf",
      "http_status": 200,
      "operation_id": "listCharges",
      "operation_method": "GET",
      "operation_path": "/v1/charges",
      "origin": "agent",
      "pinned_revisions": {
        "stripe.com:stripe:2024-04-10": "3f2b8c1e-7d4a-4e9b-a6c5-1d2e3f4a5b6c"
      },
      "started_at": "2026-01-15T09:30:00Z",
      "status": "completed",
      "toolkit_id": "tk_6968b3981ec22d56dbbc91e8",
      "toolkit_name": "billing-toolkit",
      "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0="
}

Changes

  • c516481e6ed8Revision changes
    • info

      the endpoint scheme security OAuth2 was added to the API

  • eb1cfb784ec0Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status