CFs submitted against a task, in Merkle Layer-1 order

An unknown task is a **404**; a known task with no CFs is a 200 with an empty page — the two are deliberately distinguished, unlike `/datasets/{id}/cfs`. See `TaskCfsPage` for the two properties that matter to a consumer building a dataset: the ordering guarantee, and the fact that this is a live listing rather than a snapshot.

GET

/v1/tasks/{id}/cfs

Path Parameters

`id`
Required
string

The task's 32-byte id.

Pattern: "^0[xX][0-9a-fA-F]{64}$"

Query Parameters

`limit`integer

Page size. Server-configured default and ceiling (API_DEFAULT_LIMIT / API_MAX_LIMIT; 50 and 200 unless overridden). A value above the ceiling is silently clamped, not rejected — check pagination.limit in the response rather than assuming the requested value was honoured. Values below 1, or non-integers, are a 400.

Minimum: 1

`cursor`string

Opaque cursor from a previous response's pagination.nextCursor. Omit for the first page. A malformed cursor is a 400.

curl -X GET "http://lineage-api.xny-staging.svc.cluster.local:8001/v1/tasks/0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41/cfs?limit=1&cursor=string"

A page of the task's current CF set.

{
  "items": [
    {
      "cfId": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "taskId": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "contributorDidId": "00000000-0000-0000-0000-0000000007d1",
      "metadataHash": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "metadataUri": "string",
      "kind": 0,
      "verdict": 0,
      "qualityGrade": 0,
      "parentCfId": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "blockNumber": 0,
      "logIndex": 0
    }
  ],
  "pagination": {
    "limit": 0,
    "nextCursor": "string",
    "hasMore": true
  },
  "taskId": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41"
}

CFs submitted against a task, in Merkle Layer-1 order

Path Parameters

idRequiredstring

Query Parameters

limitinteger

cursorstring

Response

TypeScript

`id`
Required
string

`limit`integer

`cursor`string