Skip to main content
GET
/
v0
/
user
/
agent-tasks
/
List All Agent Tasks
curl --request GET \
  --url https://api.sumvin.com/v0/user/agent-tasks/ \
  --header 'x-sumvin-pat: <api-key>'
{
  "_links": {},
  "tasks": [
    {
      "id": "<string>",
      "user_strategy_id": "<string>",
      "started_at": 123,
      "completed_at": 123,
      "result": {},
      "error_message": "<string>",
      "error_code": "<string>",
      "created_at": 123,
      "workflow_run_id": "<string>",
      "task": "<string>",
      "title": "<string>",
      "transactions": [
        {
          "id": "<string>",
          "type": "<string>",
          "status": "<string>",
          "direction": "<string>",
          "amount": "<string>",
          "asset_symbol": "<string>",
          "tx_hash": "<string>",
          "created_at": 123
        }
      ],
      "pints": [
        {
          "id": "<string>",
          "pint_uri": "<string>",
          "status": "<string>",
          "scopes": [
            "<string>"
          ],
          "enforcement_mode": "<string>",
          "expires_at": 123,
          "created_at": 123
        }
      ],
      "ipas": [
        {
          "id": "<string>",
          "intent_type": "<string>",
          "status": "<string>",
          "autonomy_level": "<string>",
          "created_at": 123,
          "raw_intent": "<string>",
          "completed_at": 123
        }
      ],
      "workflow_ipas": [
        {
          "id": "<string>",
          "intent_type": "<string>",
          "status": "<string>",
          "autonomy_level": "<string>",
          "created_at": 123,
          "raw_intent": "<string>",
          "completed_at": 123
        }
      ],
      "user_strategy": {
        "id": "<string>",
        "strategy": {
          "id": "<string>",
          "name": "<string>",
          "description": "<string>",
          "type": "<string>",
          "cron": "<string>",
          "base_prompt": "<string>",
          "created_at": 123,
          "event_topic": "<string>",
          "workflow_route": "<string>"
        },
        "connector": {
          "id": "<string>",
          "name": "<string>",
          "description": "<string>",
          "icon_url": "<string>",
          "auth_type": "<string>"
        },
        "is_active": true,
        "configuration": {},
        "created_at": 123,
        "event_filter": {}
      },
      "strategy": {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "type": "<string>",
        "cron": "<string>",
        "base_prompt": "<string>",
        "created_at": 123,
        "event_topic": "<string>",
        "workflow_route": "<string>"
      }
    }
  ],
  "total": 123
}

Authorizations

x-sumvin-pat
string
header
required

Personal access token issued to the Sumvin CLI. Send it in the x-sumvin-pat header to authenticate as the owning user.

Headers

x-juno-orgid
string | null

Tenant org ID for multi-tenant auth

x-sumvin-token
string | null
x-sumvin-pat
string | null
x-juno-jwt
string | null
X-Timestamp-Format
string

Controls how timestamp fields are serialized in JSON response bodies.

Default (header omitted or any other value): epoch milliseconds as integers. iso8601: UTC ISO 8601 strings of the form YYYY-MM-DDTHH:MM:SSZ.

Example: with X-Timestamp-Format: iso8601, the field value 1704067200000 becomes "2024-01-01T00:00:00Z".

Affected fields (recursively, in dicts and arrays): any field whose name ends in _at, plus the literal field names timestamp, period_start, and period_end. All other fields are passed through unchanged.

Only iso8601 is recognized. Any other value (or omitting the header) yields the default epoch-ms representation; the server does not reject unknown values, so this is documented as an example rather than an enum to keep generated clients permissive.

Example:

"iso8601"

Query Parameters

status
string | null
limit
integer
default:20
Required range: x <= 100
offset
integer
default:0
Required range: x >= 0
expand
string[]

Expand related resources. Options: transactions, user_strategy, strategy, user_strategy.strategy, ipas, workflow_ipas

Response

All agent tasks retrieved successfully

HAL-style hypermedia links for navigation and available actions.

tasks
UserAgentTaskData · object[]
required
total
integer
required