Set a task's status

Beta

POST

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

POST

/api/v0/tasks/:asset_id/status

curl -X POST https://api.athenaintel.com/api/v0/tasks/asset_id/status \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "status": "done"
}'

{
  "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"
}

Mark a task done, or open it again. Needs edit access, and the task must not be in the trash. Marking it done records who and when; reopening clears both.

Authentication

X-API-KEYstring

API Key authentication via header

Path parameters

asset_idstringRequired

The task's asset id.

Request

This endpoint expects an object.

statusenumRequired

open or done.

Allowed values:

Response

The task, read as the caller.

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

503

Service Unavailable Error

Authentication

Path parameters

Headers

Request

Response

Errors