Get a task

Beta

GET

https://api.athenaintel.com/api/v0/tasks/:asset_id

GET

/api/v0/tasks/:asset_id

curl https://api.athenaintel.com/api/v0/tasks/asset_id \
     -H "X-API-KEY: <apiKey>"

{
  "assignee": {
    "display_name": "Ada Lovelace",
    "kind": "person",
    "ref": "user_123"
  },
  "can_edit": true,
  "completed_at": "2024-01-15T09:30:00Z",
  "completed_by_ref": "string",
  "created_at": "2026-11-11T15:00:00+00:00",
  "created_by": "user_123",
  "description": "string",
  "due_date": "2026-11-13",
  "due_time": "15:00",
  "due_time_zone": "America/New_York",
  "id": "asset_7c1e5b2a-4f3d-4e8a-9b6c-1d2e3f4a5b6c",
  "is_archived": false,
  "labels": [
    {
      "applied_at": "2026-11-11T15:00:00+00:00",
      "applied_by_ref": "user_123",
      "color": "string",
      "name": "Investor"
    }
  ],
  "links": [
    {
      "detail": "string",
      "id": "string",
      "readable": true,
      "referenced": "external_url",
      "title": "example.com",
      "url": "https://example.com"
    }
  ],
  "priority": "high",
  "status": "open",
  "title": "Send the deck to Mayfield",
  "updated_at": "2026-11-11T15:00:00+00:00",
  "workspace_id": "ws_abc123-def456"
}

One task the caller can open: its status, due date, priority, assignee, labels, the records it links (each read with the caller’s own access: one they can’t open shows its kind only) and whether they may change it.

Authentication

X-API-KEYstring

API Key authentication via header

Path parameters

asset_idstringRequired

The task's asset id.

Response

The task.

assigneeobject or null

Who it is for, or null for nobody.

can_editboolean or null

Whether the caller may change it; null in a list.

completed_atdatetime or null

When it was marked done.

completed_by_refstring or null

Who marked it done.

created_atdatetime or null

created_bystring or null

The user who created it.

descriptionstring or null

Markdown.

due_datestring or null

YYYY-MM-DD, or null.

due_timestring or null

HH:MM (24-hour), or null.

due_time_zonestring or null

The IANA time zone of due_time.

idstring

The task's asset id.

is_archivedboolean

Whether it is in the trash.

labelslist of objects

linkslist of objects

The records it is about, read as the caller. Always empty in a list.

priorityenum

Allowed values:

statusenum

Allowed values:

titlestring

updated_atdatetime or null

workspace_idstring

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

Authentication

Path parameters

Headers

Response

Errors