> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Deadline

> Mark a deadline done, assign it, add a note, or acknowledge a review flag

**Credits:** 0 per request.

Requires `portfolios:manage` and an `Idempotency-Key` header. Free.

| Field | Applies to | Meaning |
| - | - | - |
| `status` | every deadline | `open`, `done` or `dismissed`. `done` sets `done_at`; moving away from `done` clears it. |
| `assignee` | every deadline | Free text, or `null` to clear. |
| `note` | every deadline | Free text, or `null` to clear. |
| `review_required` | every deadline | Only `false`: acknowledges the flag and clears `review_reason`. |
| `title`, `due_date` | manual deadlines | A computed deadline's dates follow office data: changing them is 409 `deadline_not_editable`. |

Send at least one field. Each change is recorded in the deadline's history; a
request that changes nothing records nothing and leaves `updated_at` as it was.
Signa never changes `status`, `assignee` or `note`. When the due date of a
deadline you marked `done` moves, it stays `done` and is flagged for review.

```typescript theme={null}
await signa.deadlines.update('dl_019d2141-6ce9-771b-872e-bc8b20e49fcf', {
  status: 'done',
  note: 'Filed 2026-04-11, receipt 123456',
});
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.