---
title: "Set meeting deadlines"
method: POST
path: "/api/meetings/{id}/deadlines"
tags: ["Meetings"]
---

# Set meeting deadlines

`POST /api/meetings/{id}/deadlines`

## Request

- Base URL: `https://api.wondercal.com`
- URL: `https://api.wondercal.com/api/meetings/{id}/deadlines`
- Auth: HTTP bearer

Set or clear a meeting's deadlines so it happens by a certain date. Only the organizer can set deadlines, and the meeting must be unconfirmed. All fields are optional: omit a field to leave it unchanged, or pass null for meetBy/respondBy to clear that deadline. To guarantee a meeting is scheduled by a date, set meetBy plus a respondBy (on or before meetBy) with onResponseDeadline='auto_schedule'. onResponseDeadline='auto_schedule' REQUIRES meetBy to be set (in this request or already saved on the meeting) — clearing meetBy with respondBy/onResponseDeadline='auto_schedule' still in effect is rejected.

## Path parameters

- `id` string, required

## Request body

- object
  - `meetBy` string, date-time, nullable: Latest date/time the meeting may be scheduled for (ISO 8601). null clears it.
  - `respondBy` string, date-time, nullable: Response deadline (ISO 8601), on or before meetBy. null clears it.
  - `onResponseDeadline` 'auto_schedule' | 'notify_organizer', nullable: What happens when respondBy passes. Required when setting respondBy; defaults to notify_organizer. 'auto_schedule' requires meetBy to be set (in this request or already saved on the meeting).

## Response `200`

Deadlines updated

- object
  - `data` object
    - `id` string
    - `meetBy` string, date-time, nullable
    - `respondBy` string, date-time, nullable
    - `onResponseDeadline` 'auto_schedule' | 'notify_organizer', nullable

## Other responses

- `400`: Invalid deadline values
- `401`: Not authenticated
- `403`: User is not the organizer
- `404`: Meeting not found
- `422`: Meeting is confirmed and cannot be modified
- `429`: Rate limit exceeded. The Retry-After header indicates how many seconds to wait before retrying.

---

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