---
title: "Update one deadline"
method: PATCH
path: "/deadlines/{id}"
---

# Update one deadline

`PATCH /deadlines/{id}`

## Request

- Base URL: `https://www.scadenzario.app/api/v1`
- URL: `https://www.scadenzario.app/api/v1/deadlines/{id}`
- Auth: HTTP bearer

## Request body

- UpdateDeadlinePatch
  - `title` string
  - `notes` string, nullable
  - `emoji` string, nullable
  - `due_at` string
  - `time_zone` string
  - `amount` number, nullable
  - `transaction_type` 'none' | 'expense' | 'income'
  - `is_paid` boolean
  - `label_id` string
  - `label_ids` string[]
  - `reminder_days` integer[]
  - `notification_times` string[]

## Response `200`

The updated deadline.

- object
  - `deadline` Deadline, required
    - `id` string, required
    - `title` string, required
    - `due_at` string, date-time, required
    - `notes` string, nullable
    - `emoji` string, nullable
    - `recurrence` 'none' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'multiple_daily' | 'interval' | 'specific_dates' | 'yearly_dates' | 'quarterly' | 'bimonthly' | 'biennial' | 'semiannual', required
    - `custom_interval` integer
    - `reminder_days` integer[]
    - `notification_times` string[]
    - `amount` number, nullable
    - `transaction_type` 'none' | 'expense' | 'income'
    - `is_paid` boolean
    - `paid_at` string, date-time, nullable
    - `paid_amount` number, nullable: Amount actually paid, when it differs from amount.
    - `is_done` boolean, required
    - `label_id` string, nullable
    - `label_ids` string[]
    - `has_attachment` boolean
    - `created_at` string, nullable
    - `updated_at` string, nullable

## Other responses

- `400`: Invalid input.
- `401`: Missing or invalid token.
- `403`: Missing scope (token without write access).
- `404`: Unknown or deleted id.
- `409`: Recurring date change (unsupported_for_recurring) or plan limit.

---

[API](https://skmtc.dev/scadenzario/apis/scadenzario-api.md) · [All operations](https://skmtc.dev/scadenzario/apis/scadenzario-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scadenzario/apis/scadenzario-api/revisions/4ad6b339ccef?raw)