> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.
# Update a Deadline
> Use this endpoint to update an existing deadline by its ID. Only the fields included in the request body are updated.
These endpoints power deadline management in the **Console**. You can also call them directly to integrate deadlines into your own systems.
## OpenAPI
````yaml en/openapi/v3-current/reporter.yaml patch /v1/deadlines/{id}
openapi: 3.1.0
info:
title: Reporter
description: ''
version: 2.1.2
servers:
- url: https://reporter.sandbox.lerian.net
security: []
tags: []
paths:
/v1/deadlines/{id}:
patch:
tags:
- Deadlines API
summary: Update a Deadline
description: >-
Use this endpoint to update an existing deadline by its ID. Only the
fields included in the request body are updated.
parameters:
- $ref: '#/components/parameters/DeadlineId'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/XOrganizationId'
- $ref: '#/components/parameters/XIdempotency'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateDeadlineInput'
example:
name: Updated Report Name
description: Updated description
type: custom
frequency: annual
dueDate: '2026-06-30T23:59:59Z'
color: '#00FF00'
notifyDaysBefore: 10
active: false
responses:
'200':
description: Indicates that the deadline was successfully updated.
content:
application/json:
schema:
$ref: '#/components/schemas/Deadline'
headers: {}
'400':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
Error0009:
$ref: '#/components/examples/Error0009'
Error0017:
$ref: '#/components/examples/Error0017'
Error0018:
$ref: '#/components/examples/Error0018'
'404':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
Error0011:
$ref: '#/components/examples/Error0011'
security: []
components:
parameters:
DeadlineId:
name: id
in: path
description: Unique identifier of the deadline that you want to manage.
required: true
schema:
type: string
Authorization:
name: Authorization
in: header
description: >-
The authorization token in the 'Bearer ' format.
**Important:** This header is required if your environment has Access
Manager enabled. For more information, refer to the [Access
Manager](/en/access-manager) documentation.
required: false
schema:
type: string
XOrganizationId:
name: X-Organization-id
in: header
description: The unique identifier of the Organization associated with the request.
required: true
example: 019c96a0-0a98-7287-9a31-786e0809c769
schema:
type: string
XIdempotency:
name: X-Idempotency
in: header
description: >-
Optional idempotency key for safe retries. If omitted, the server may
generate one automatically.
See [Retries and idempotency](/en/reference/retries-idempotency) for
details.
required: false
schema:
type: string
schemas:
UpdateDeadlineInput:
type: object
description: >-
The input payload to update a deadline. Only the provided fields are
updated.
properties:
name:
type: string
description: Human-readable name of the deadline.
description:
type: string
description: Optional description of the deadline.
type:
type: string
description: Type of the deadline (e.g., `regulatory`, `custom`).
frequency:
type: string
description: How often the deadline recurs (e.g., `monthly`, `annual`).
dueDate:
type: string
description: The date and time when the deadline is due, in RFC 3339 format.
color:
type: string
description: Color used to visually identify the deadline (hex format).
notifyDaysBefore:
type: integer
description: Number of days before the due date when notifications start.
monthsOfYear:
type: array
description: Months of the year (1-12) in which the deadline applies.
items:
type: integer
templateId:
type: string
description: >-
Unique identifier of the template used to fulfill the deadline
(UUID).
active:
type: boolean
description: Whether the deadline is active.
Deadline:
type: object
description: Details about a deadline.
properties:
id:
type: string
description: Unique identifier of the deadline (UUID).
name:
type: string
description: Human-readable name of the deadline.
description:
type: string
description: Description of the deadline.
type:
type: string
description: Type of the deadline (e.g., `regulatory`, `custom`).
frequency:
type: string
description: How often the deadline recurs (e.g., `monthly`, `annual`).
dueDate:
type: string
description: The date and time when the deadline is due, in RFC 3339 format.
color:
type: string
description: Color used to visually identify the deadline (hex format).
notifyDaysBefore:
type: integer
description: Number of days before the due date when notifications start.
monthsOfYear:
type: array
description: Months of the year (1-12) in which the deadline applies.
items:
type: integer
templateId:
type: string
description: >-
Unique identifier of the template used to fulfill the deadline
(UUID).
templateName:
type: string
description: Name of the template used to fulfill the deadline.
status:
type: string
description: >-
Current status of the deadline (e.g., `pending`, `overdue`,
`delivered`).
active:
type: boolean
description: Whether the deadline is active.
deliveredAt:
type: string
description: Timestamp marking when the deadline was delivered, if applicable.
createdAt:
type: string
description: Timestamp marking when the deadline was created.
updatedAt:
type: string
description: Timestamp marking the last update to the deadline.
Error:
type: object
properties:
code:
type: string
description: A unique, stable identifier for the error.
title:
type: string
description: A brief summary of the issue.
message:
type: string
description: Detailed guidance for resolving the error.
description: Response message error.
required:
- code
- title
- message
examples:
Error0009:
summary: Invalid Path Parameter
value:
code: TPL-0009
title: Invalid Path Parameter
message: >-
Path parameters is in an incorrect format. Please check the following
parameter %v and ensure they meet the required format before trying
again.
Error0017:
summary: Bad Request
value:
code: TPL-0017
title: Bad Request
message: >-
The server could not understand the request due to malformed syntax.
Please check the listed fields and try again.
Error0018:
summary: Internal Server Error
value:
code: TPL-0018
title: Internal Server Error
message: >-
The server encountered an unexpected error. Please try again later or
contact support.
Error0011:
summary: Entity Not Found
value:
code: TPL-0011
title: Entity Not Found
message: >-
No %v entity was found for the given ID. Please make sure to use the
correct ID for the entity you are trying to manage.
````