Tasks · Oblive Docs

List tasks

GET/organizations/{organizationId}/tasks

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Query Parameters

cursor?string

Formatuuid

limit?integer

sortBy?string

Value in

"id"
"identifier"
"title"
"priority"
"status"
"scheduledAt"
"dueAt"
"createdAt"
"updatedAt"

sortDirection?string

Value in

"asc"
"desc"

identifier?string

ownerAgentProfileId?string

Formatuuid

parentId?string

Formatuuid

sourceChatId?string

Formatuuid

sourceMessageId?string

Formatuuid

kind?string

Value in

"initiative"
"task"
"research"
"review"
"learn"

status?string

Value in

"pending"
"blocked"
"running"
"waiting_human"
"done"
"failed"
"cancelled"

phase?string

Value in

"plan"
"execute"
"research"
"review"
"verify"
"learn"
"awaiting_descendants"

rootTaskId?string

Formatuuid

rootOnly?boolean

Response Body

`application/json`

curl -X GET "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks"

{  "success": true,  "statusCode": 200,  "message": "Tasks listed.",  "data": [    {      "id": "b12e12e7-68df-4ba8-a72a-32eb80d60b64",      "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",      "identifier": "ENG-1",      "identifierScope": "engineering",      "identifierNumber": 1,      "parentId": null,      "rootTaskId": null,      "depth": 0,      "ownerAgentProfileId": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",      "sourceChatId": "0ce65ee0-dcd9-46c2-90a4-243f5d54dc66",      "sourceMessageId": "380c8d1f-7a6a-4a8d-8dd9-3e9ecda3f4f1",      "kind": "task",      "status": "pending",      "phase": "execute",      "title": "Create onboarding plan",      "priority": 10,      "version": 1,      "graphRevision": 1,      "agentRunCount": 0,      "consumedAgentRunCount": 0,      "replanCount": 0,      "createdByRunId": null,      "spec": {        "objective": "Create the onboarding plan.",        "inputs": [],        "acceptanceCriteria": [          {            "kind": "output_file",            "path": "outputs/onboarding-plan.json",            "checks": [              {                "kind": "media_type",                "anyOf": [                  "application/json"                ]              },              {                "kind": "json_pointer",                "pointer": "/status",                "operator": "eq",                "value": "ready"              }            ]          }        ],        "budget": {          "maxAgentRuns": 6,          "maxAttemptsPerPhase": 3,          "maxReplans": 1,          "maxActions": 10        }      },      "state": {        "blockers": [],        "activeRunIds": []      },      "result": null,      "dedupeKey": "onboarding-plan",      "scheduledAt": "2026-01-01T00:00:00.000Z",      "dueAt": null,      "startedAt": null,      "completedAt": null,      "createdAt": "2026-01-01T00:00:00.000Z",      "updatedAt": "2026-01-01T00:00:00.000Z"    }  ],  "pagination": {    "cursor": null,    "limit": 50,    "nextCursor": null,    "previousCursor": null,    "hasNextPage": false,    "hasPreviousPage": false  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

Get task

GET/organizations/{organizationId}/tasks/{taskRef}

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task reference.

Response Body

`application/json`

curl -X GET "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string"

{  "success": true,  "statusCode": 200,  "message": "Task found.",  "data": {    "id": "b12e12e7-68df-4ba8-a72a-32eb80d60b64",    "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "identifier": "ENG-1",    "identifierScope": "engineering",    "identifierNumber": 1,    "parentId": null,    "rootTaskId": null,    "depth": 0,    "ownerAgentProfileId": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",    "sourceChatId": "0ce65ee0-dcd9-46c2-90a4-243f5d54dc66",    "sourceMessageId": "380c8d1f-7a6a-4a8d-8dd9-3e9ecda3f4f1",    "kind": "task",    "status": "pending",    "phase": "execute",    "title": "Create onboarding plan",    "priority": 10,    "version": 1,    "graphRevision": 1,    "agentRunCount": 0,    "consumedAgentRunCount": 0,    "replanCount": 0,    "createdByRunId": null,    "spec": {      "objective": "Create the onboarding plan.",      "inputs": [],      "acceptanceCriteria": [        {          "kind": "output_file",          "path": "outputs/onboarding-plan.json",          "checks": [            {              "kind": "media_type",              "anyOf": [                "application/json"              ]            },            {              "kind": "json_pointer",              "pointer": "/status",              "operator": "eq",              "value": "ready"            }          ]        }      ],      "budget": {        "maxAgentRuns": 6,        "maxAttemptsPerPhase": 3,        "maxReplans": 1,        "maxActions": 10      }    },    "state": {      "blockers": [],      "activeRunIds": []    },    "result": null,    "dedupeKey": "onboarding-plan",    "scheduledAt": "2026-01-01T00:00:00.000Z",    "dueAt": null,    "startedAt": null,    "completedAt": null,    "createdAt": "2026-01-01T00:00:00.000Z",    "updatedAt": "2026-01-01T00:00:00.000Z"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 404,  "message": "Task not found.",  "error": {    "code": "task_not_found"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

Get task hierarchy and dependencies

GET/organizations/{organizationId}/tasks/{taskRef}/graph

Returns one consistent read projection for the focused task's root hierarchy, dependency edges, and boundary tasks from related roots.

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or organization-local identifier.

Response Body

`application/json`

curl -X GET "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/graph"

{  "success": true,  "statusCode": 200,  "message": "Task graph found.",  "data": {    "focusTaskId": "b12e12e7-68df-4ba8-a72a-32eb80d60b64",    "rootTaskId": "b12e12e7-68df-4ba8-a72a-32eb80d60b64",    "tasks": [      {        "id": "b12e12e7-68df-4ba8-a72a-32eb80d60b64",        "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",        "identifier": "ENG-1",        "identifierScope": "engineering",        "identifierNumber": 1,        "parentId": null,        "rootTaskId": null,        "depth": 0,        "ownerAgentProfileId": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",        "sourceChatId": "0ce65ee0-dcd9-46c2-90a4-243f5d54dc66",        "sourceMessageId": "380c8d1f-7a6a-4a8d-8dd9-3e9ecda3f4f1",        "kind": "task",        "status": "pending",        "phase": "execute",        "title": "Create onboarding plan",        "priority": 10,        "version": 1,        "graphRevision": 1,        "agentRunCount": 0,        "consumedAgentRunCount": 0,        "replanCount": 0,        "createdByRunId": null,        "spec": {          "objective": "Create the onboarding plan.",          "inputs": [],          "acceptanceCriteria": [            {              "kind": "output_file",              "path": "outputs/onboarding-plan.json",              "checks": [                {                  "kind": "media_type",                  "anyOf": [                    "application/json"                  ]                },                {                  "kind": "json_pointer",                  "pointer": "/status",                  "operator": "eq",                  "value": "ready"                }              ]            }          ],          "budget": {            "maxAgentRuns": 6,            "maxAttemptsPerPhase": 3,            "maxReplans": 1,            "maxActions": 10          }        },        "state": {          "blockers": [],          "activeRunIds": []        },        "result": null,        "dedupeKey": "onboarding-plan",        "scheduledAt": "2026-01-01T00:00:00.000Z",        "dueAt": null,        "startedAt": null,        "completedAt": null,        "createdAt": "2026-01-01T00:00:00.000Z",        "updatedAt": "2026-01-01T00:00:00.000Z"      }    ],    "relatedTasks": [],    "dependencies": []  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 404,  "message": "Task graph not found.",  "error": {    "code": "task_graph_not_found"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

Retry a failed task graph

POST/organizations/{organizationId}/tasks/{taskRef}/retry

Reopens the failed origin, its failed initiative ancestors, and tasks cancelled by that failure. Completed work and run history are preserved, and aggregate run budgets are not reset.

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task identifier or UUID.

Response Body

`application/json`

curl -X POST "https://example.com/organizations/7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1/tasks/string/retry"

Empty

200application/json

400application/json

200application/json

400application/json

404application/json

200application/json

400application/json

404application/json

200application/json

404application/json

409application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`