Held Executions

List held executions

Changed on

List the held executions the caller may see, newest first.

org:admin sees every one; a user sees those filed by agents they own; an agent sees its own. Filter by state (e.g. pending) or agent_id.

get/executions/holds

Request

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

Query parameters

state'pending' | 'approved' | 'denied' | 'expired' | 'withdrawn'

Lifecycle of an execution approval; every state but pending is terminal.

Only return held executions in this decision state, e.g. pending.

agent_idstring nullable

Only return held executions filed by this agent.

Example:agnt_6968b3984d1c238dbe7e2e29
cursorstring nullable

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

Example:eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0=
limitinteger

Maximum number of held executions 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": {
        "execution": "https://jentic.example.com/executions/exec_6968b3982706c619fe73f0cf",
        "result": "https://jentic.example.com/executions/holds/held_6968b398a1c4e2d07b5f93c6/result",
        "self": "https://jentic.example.com/executions/holds/held_6968b398a1c4e2d07b5f93c6",
        "withdraw": "https://jentic.example.com/executions/holds/held_6968b398a1c4e2d07b5f93c6:withdraw"
      },
      "agent_id": "agnt_6968b3984d1c238dbe7e2e29",
      "api_name": "stripe",
      "api_vendor": "stripe.com",
      "api_version": "2024-04-10",
      "created_at": "2026-01-15T09:30:00Z",
      "credential_id": "cred_6968b39855d91a3561684b32",
      "decided_at": "2026-01-15T09:42:00Z",
      "decided_by": "usr_6968b3987ee4c3ec0b4ee3b9",
      "decision_reason": "Not this account",
      "execution_id": "exec_6968b3982706c619fe73f0cf",
      "execution_status": "held",
      "expires_at": "2026-01-15T10:30:00Z",
      "id": "held_6968b398a1c4e2d07b5f93c6",
      "matched_rule_id": "apr_6968b398c4e1a2b3d5f60718",
      "method": "POST",
      "operation_id": "listCharges",
      "path": "/v1/refunds",
      "review_url": "https://jentic.example.com/app/agents/approvals/held_6968b398a1c4e2d07b5f93c6",
      "state": "pending",
      "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
      "updated_at": "2026-01-15T09:42:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0="
}

Changes