Skip to content
Everruns Everruns

List tasks

GET
/v1/durable/tasks
 
curl --request GET \
  --url https://app.everruns.com/api/v1/durable/tasks

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
status
string

Filter by status

activity_type
string

Filter by activity type

workflow_id
string format: uuid

Filter by workflow ID

offset
integer format: int32

Pagination offset

limit
integer format: int32

Pagination limit

Responses

Section titled “ Responses ”

200

Section titled “200 ”

List of tasks

Media type application/json

Tasks list response

object
data
required

Page of items returned by this query.

Array<object>

Task response

object
activity_id
required

Stable per-workflow activity ID (used for deduplication within a workflow run).

string
activity_type
required

Activity type name, used by workers to route the task.

string
attempt
required

Attempt counter. 0 before the task has ever been claimed; incremented to 1 on the first claim and once more per retry.

integer format: int32
claimed_at

Timestamp when this task was last claimed by a worker (RFC 3339). None if never claimed.

string | null format: date-time
claimed_by

Worker ID that holds the current claim; None if pending or terminal.

string | null
created_at
required

Timestamp when this task was enqueued (RFC 3339).

string format: date-time
id
required

UUID of the task.

string format: uuid
last_error

Last error message recorded by the worker; None if the task has never failed.

string | null
max_attempts
required

Maximum number of attempts before the task is sent to the DLQ.

integer format: int32
priority
required

Priority; higher values run first within the same activity type.

integer format: int32
status
required

Current lifecycle status (pending, claimed, completed, failed, dead, cancelled).

string
workflow_id

Owning workflow’s identifier. None for one-off tasks not tied to a workflow.

string | null format: uuid
total
required

Total number of items matching the query, across all pages.

integer
Example generated
{
  "data": [
    {
      "activity_id": "example",
      "activity_type": "example",
      "attempt": 1,
      "claimed_at": "2026-04-15T12:00:00Z",
      "claimed_by": "example",
      "created_at": "2026-04-15T12:00:00Z",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "last_error": "example",
      "max_attempts": 1,
      "priority": 1,
      "status": "example",
      "workflow_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
    }
  ],
  "total": 1
}

500

Section titled “500 ”

Internal server error

Media type application/json

Standard error response.

Wire shape is RFC 9457 Problem Details: every error response includes title and status, and may include detail, code, allowed_actions, retry_after_seconds, instance, and type. The content type is rewritten to application/problem+json by [problem_json_content_type].

object
allowed_actions

Recovery actions the caller can take next.

Array<object>

Agent-actionable recovery hint attached to an error response.

object
hint

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).

string | null
href

Optional absolute or relative URL the caller may invoke directly.

string | null
operation_id

OpenAPI operationId the caller should invoke to recover.

string | null
rel
required

Link relation describing the action (e.g. retry, get-existing, unarchive, retry-later).

string
code

Stable, machine-readable error code (snake_case).

string | null
detail

Human-readable explanation specific to this occurrence.

string | null
instance

Request URI for this occurrence.

string | null
retry_after_seconds

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32
status
required

HTTP status code; mirrors the response status line.

integer format: int32
title
required

Short, human-readable summary of the problem (e.g. “Not Found”).

string
type

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null
Example generated
{
  "allowed_actions": [
    {
      "hint": "example",
      "href": "example",
      "operation_id": "example",
      "rel": "example"
    }
  ],
  "code": "example",
  "detail": "example",
  "instance": "example",
  "retry_after_seconds": 1,
  "status": 1,
  "title": "example",
  "type": "example"
}