GetItDoneGetItDone Docs
API ReferenceTask dependencies

Remove a blocker

DELETE
/v1/tasks/{task_id}/dependencies/{blocker_task_id}

Removes the blocked-by link between the two tasks — neither task is otherwise touched, and completion history is untouched. Removing a link that is not there succeeds unchanged, so retries are safe. When this frees the task (its last OPEN blocker is gone), the task.unblocked webhook fires — the same event a blocker being completed or archived produces. Answers the task's full dependency view after the removal.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A gid_ API key (Profile → API Keys) or an OAuth 2.1 access token.

Path Parameters

task_id*string

Task short id, e.g. T-123 (a bare 123 is also accepted on input).

Match^(?:T-)?[0-9]{1,12}$
blocker_task_id*string

The blocker to unlink from the task in the path.

Match^(?:T-)?[0-9]{1,12}$

Response Body

The task's dependencies after the link was removed.

application/json
  1. response

Both directions of a task's blocker graph, one hop out, plus its derived blocked state.

task_id*string

The task this view is for.

Match^(?:T-)?[0-9]{1,12}$
is_blocked*boolean

DERIVED on every read: true when at least one entry in blocked_by is still open. Never a stored column and never written to the task's status — a blocked task keeps whatever status its owner set.

blocked_by_count*integer

How many tasks must finish first, open or not — blocked_by.length.

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

How many tasks wait on this one — blocking.length.

Range-9007199254740991 <= value <= 9007199254740991
blocked_by*array<>

Tasks that must finish before this one can be worked on, oldest link first.

blocking*array<>

Tasks waiting on this one, oldest link first — the other direction of the same edges.

Example Request
curl -X DELETE 'https://app.nowgetitdone.com/v1/tasks/T-123/dependencies/T-123'
Example Response
{  "task_id": "T-123",  "is_blocked": true,  "blocked_by_count": 2,  "blocking_count": 1,  "blocked_by": [    {      "task_id": "T-123",      "title": "Ship the public API",      "status": "TODO",      "open": true    }  ],  "blocking": [    {      "task_id": "T-123",      "title": "Ship the public API",      "status": "TODO",      "open": true    }  ]}

Record a blocker POST

Records that the task in the path is blocked by blocker_task_id — the SAME operation the MCP link_task_dependency tool executes. Recording a link that already…

List a task's occurrences GET

Cursor-paginated ledger of the days a repeating task is due, most recent day first. Filter with status, and with starting_on / ending_on for a calendar window…