Executions

Get Execution

Changed on

Get an execution record by ID.

get/executions/{execution_id}

Request

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

Path parameters

execution_idstring required

ID of the execution record.

Example:exec_6968b3982706c619fe73f0cf

Response

Successful Response

actor_idstring required

ID of the actor that ran the execution.

actor_typestring required

Kind of actor that ran the execution, e.g. user or agent. Opaque string: historical rows may carry a retired type.

created_atstring date-time required

When the execution record was created (RFC 3339).

credential_idstring nullable

ID of the credential used. Null for inline auth, credential-less APIs, older records and executions that failed before a credential was chosen.

credential_namestring nullable

Name of the credential used; null when no credential is recorded.

duration_msinteger nullable

Duration of the execution in milliseconds; null if unknown.

errorstring nullable

Short error message (at most 128 characters) for a failed execution.

execution_idstring required

Unique ID of the execution record.

http_statusinteger nullable

HTTP status returned by the upstream; null if no upstream response.

operation_idstring nullable

Machine identifier of the operation called; null when none was resolved.

operation_methodstring nullable

The operation's HTTP method, e.g. GET. Null whenever operation_path is null.

operation_pathstring nullable

The operation's spec path template, e.g. /repos/{owner}/{repo}. Null when the record carries no human-readable operation identity: records predating the column, executions of a URL that resolved to no registered operation, and async jobs enqueued with only an operation_id. Display surfaces show a placeholder for such rows — the opaque operation_id is a machine key, not a human fallback.

originstring nullable

Surface the execution was initiated from, e.g. api, agent or mcp; null if not recorded.

pinned_revisionsobject nullable

Pinned API revisions used, keyed vendor:name:version with the revision ID as value; null when no pin applied.

started_atstring date-time required

When the execution started (RFC 3339).

statusstring required

Terminal outcome: completed or failed. An upstream response with HTTP status 400 or above counts as failed.

toolkit_idstring nullable

Legacy: toolkit that mediated the execution. Null for direct-binding executions; attribute those via credential_id instead.

toolkit_namestring nullable

Legacy: name of the toolkit in toolkit_id; null when unavailable.

trace_idstring required

Trace ID of the execution request.

Example response

{
  "_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"
}

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