Skip to content
dhanu docs
Browse pages

API reference

Read a task

GET /api/pub/v1/tasks/{taskId}, read a task the key's workspace owns.

GEThttps://api.dhanu.ai/api/pub/v1/tasks/{taskId}

Reads one task. The task must belong to the key’s workspace; anything else is not_found, so a key can never confirm that a task exists elsewhere.

Request

Path parameterTypeRequiredNotes
taskIdstringYes
curl https://api.dhanu.ai/api/pub/v1/tasks/$TASK_ID \
  -H "Authorization: Bearer $DHANU_API_KEY"
const task = await dhanu.tasks.get(taskId);
task = dhanu.tasks.get(task_id)

Response

200 OK

{
  "task": {
    "id": "…",
    "title": "Stand-up minutes",
    "createdAt": "2026-09-17T10:15:00.000Z",
    "updatedAt": "2026-09-17T10:16:40.000Z"
  }
}

Errors

CodeStatusMeaning
invalid_api_key401The bearer key is missing or unknown.
api_key_revoked401The key was revoked.
api_key_expired401The key passed its expiry date.
api_key_ip_not_allowed403The caller's IP is outside the key's allowlist.
developer_access_revoked403The key's creator lost developer access in the workspace.
api_key_project_scope403The key covers no active projects, or projectId is outside its scope.
not_found404No such resource in the key's workspace.

The full list is on Errors.