GetItDoneGetItDone Docs
API ReferenceTasks
API ReferenceTasks

Append to a task's notes

Appends a dated entry to the end of a task's notes without rewriting them. The task_id may be the stable id or the short id. Use this for progress updates, handover entries, and structured log entries that should live on the task itself.

POST
/v1/tasks/{task_id}/notes

Appends a dated entry to the end of a task's notes without rewriting them. The task_id may be the stable id or the short id. Use this for progress updates, handover entries, and structured log entries that should live on the task itself.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A gid_ API key (Settings → API keys) or an OAuth 2.1 access token.

Path Parameters

task_id*string

Request Body

application/json
  1. body

A dated entry to append to a task's notes without rewriting them.

text*string

The entry to append (1-10000 characters). A date header is prepended automatically.

Length1 <= length <= 10000
author?string

Author label for the entry. Defaults to the credential label.

Lengthlength <= 100

Response Body

The task note after the append.

application/json
  1. response

Result of appending to a task note.

task_id*string

Task id.

short_id*integer

Human-readable short id.

Range-9007199254740991 <= value <= 9007199254740991
notes_length*integer

Character count of the notes after the append.

Range-9007199254740991 <= value <= 9007199254740991
message*string

Human-readable confirmation.

Example Request
curl -X POST 'https://app.nowgetitdone.com/v1/tasks/string/notes' \  -H 'Content-Type: application/json' \  -d '{  "text": "string"}'
Example Response
{  "task_id": "string",  "short_id": -9007199254740991,  "notes_length": -9007199254740991,  "message": "string"}

List task history GET

Cursor-paginated, read-only version history of a task, newest first — every content change (in-app, MCP or this API) is an immutable version snapshot. This is the ONE endpoint where versions surface; their ids are accepted nowhere else.

Get plan usage GET

Reports the current billing period, per-meter consumption against the plan, and the per-credential burst allowance. Reading usage never consumes the API-call quota (the meter cost is zero), so this endpoint stays reachable even when the period allowance is exhausted.