Executions

List executions (deprecated)

Deprecated: use GET /v2/executions for cursor-based traversal. V1 remains available for shallow compatibility.

Retrieve execution history for the authenticated API key's organization with optional filters. Model prediction terminal statuses include success, error, and cancelled; workflow executions can surface running, completed, failed, or cancelled depending on the originating backend. The status filter accepts the four tokens listed on the parameter; unrecognized tokens return 400.

Results cover every API key in the organization that owns the authenticated key.

Pagination: offset is retained for shallow compatibility but is deprecated for history traversal. Use GET /v2/executions and its opaque cursor to traverse matching history without an implicit total. Computing an exact total over a large execution history is expensive, so total_count can be capped and is then only a lower bound. When from is omitted, the window defaults to the 90 days ending at to (or now).

get/v1/executions

Request

  • Base URL: https://api.eachlabs.ai
  • URL: https://api.eachlabs.ai/v1/executions
  • Auth: HTTP bearer

Query parameters

limitinteger

Maximum number of executions to return

offsetinteger

Deprecated shallow-page offset; use GET /v2/executions for traversal. The maximum requested prefix is 1,000 rows, evaluated after limit normalization as offset <= 1000 - appliedLimit. Requests beyond that boundary return {"error":"V1 execution pagination is limited to 1000 rows; use GET /v2/executions with cursor pagination"}.

modelstring

Filter executions by model slug

statusstring

Comma-separated status filter. Each token must be one of created, starting, success, or error (lowercase); any other token returns 400 naming the allowed set. An empty or absent parameter applies no status filter.

workflow_idstring

Filter by workflow ID

workflow_execution_idstring

Filter by workflow execution ID

error_classification'content_moderation' | 'execution_timeout' | 'invalid_user_input' | 'invalid_model_config' | 'provider_auth' | 'provider_error' | 'provider_rate_limit' | 'provider_unavailable' | 'internal_error' | 'unknown'

Comma-separated canonical error classification filter. Restricts results to terminal error executions whose classification is in the set; an unrecognized value returns 400. Each value must be one of the listed enum members.

fromstring date-time

Start of creation time window, as RFC 3339. When omitted, defaults to 90 days before to (or before now when to is also omitted).

tostring date-time

End of creation time window, as RFC 3339

Response

List of executions

total_countinteger required

Number of matching executions. When total_capped is true this is a lower bound, not the exact total. Use GET /v2/executions and its opaque cursor for history traversal rather than relying on this count as a pagination stop condition.

total_cappedboolean required

true when the server did not compute the exact count (the count is capped, or its time budget elapsed) and total_count is a lower bound — more matching executions may exist beyond it.

offsetinteger required

Applied offset

limitinteger required

Applied limit

Example response

{
  "executions": [
    {
      "id": "exec_abc123",
      "model": "flux-1-1-pro",
      "requested_model": "openai/gpt-4.1-mini",
      "status": "success",
      "workflow_id": "wf_abc123",
      "workflow_execution_id": "wf_exec_abc123",
      "execution_cost": 0.05,
      "run_time": 12.5,
      "created_at": "2026-01-01T00:00:00Z",
      "started_at": "2026-01-01T00:00:02Z",
      "completed_at": "2026-01-01T00:00:15Z",
      "output": "https://storage.example.com/predictions/abc123/image.jpg"
    }
  ],
  "total_count": 123,
  "limit": 20
}

Changes

No recorded changes to this operation across all 1 revision of this API.