List delegate tasks

GET

/v1/delegate-tasks

GET

/v1/delegate-tasks

curl https://api.runtype.com/v1/delegate-tasks \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json"

{
  "data": [
    {
      "apiKeyId": "key_01HXYZ9ABCDEF1234567890",
      "clientName": "runtype-sdk-python",
      "clientVersion": "1.4.2",
      "completedAt": "2024-11-15T10:32:45Z",
      "createdAt": "2024-11-15T10:28:00Z",
      "error": null,
      "id": "task_01HXYZ9ABCDEF7654321098",
      "instruction": "Analyze the latest sales report and create a summary with key metrics and trends for Q3 2024.",
      "lastEventSeq": 42,
      "modelRoundCount": 5,
      "organizationId": "org_01HXYZ9ABCDEF0987654321",
      "question": null,
      "result": {
        "links": [
          {
            "label": "Q3 2024 Sales Report",
            "url": "https://app.runtype.com/reports/q3-2024-sales-summary"
          }
        ],
        "modelRoundCount": 5,
        "summary": "Analyzed Q3 2024 sales data. Total revenue increased by 18% YoY to $4.2M. Top performing product category was Enterprise licenses. Identified 3 key growth opportunities in APAC region.",
        "toolCallCount": 12,
        "touchedEntities": [
          {
            "action": "read",
            "id": "report_q3_2024_sales",
            "kind": "Report",
            "name": "Q3 2024 Sales Report"
          }
        ],
        "totalCost": 0.0842,
        "warnings": [
          "Some data points from September were incomplete and may affect accuracy."
        ]
      },
      "startedAt": "2024-11-15T10:28:05Z",
      "status": "completed",
      "summary": "Analyzed Q3 2024 sales data and generated a summary report with key metrics.",
      "toolCallCount": 12,
      "totalCost": 0.0842,
      "touchedEntities": [
        {
          "action": "read",
          "id": "report_q3_2024_sales",
          "kind": "Report",
          "name": "Q3 2024 Sales Report"
        }
      ],
      "updatedAt": "2024-11-15T10:32:45Z",
      "userId": "user_01HXYZ9ABCDEF1122334455"
    }
  ],
  "pagination": {
    "currentOffset": 0,
    "hasMore": true,
    "hasPrev": false,
    "limit": 20,
    "nextCursor": "cursor_01HXYZ9ABCDEF9988776655",
    "prevCursor": null,
    "currentPage": 1,
    "totalCount": 87,
    "totalPages": 5
  }
}

Your organization’s delegated tasks, newest first. API keys need DELEGATE_TASKS:READ.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

statusenumOptional

cursorstringOptional

limitstringOptional

Response

One page of tasks

datalist of objects

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

503

Service Unavailable Error