---
title: "Update a drop"
method: PATCH
path: "/v1/drops/{dropId}"
tags: ["drops"]
---

# Update a drop

`PATCH /v1/drops/{dropId}`

## Path parameters

- `dropId` string, required

## Request body

- object
  - `description` string, nullable — Public drop description.
  - `endAt` string, date-time, nullable — Optional end time in ISO 8601 with an explicit UTC offset.
  - `imageUrl` string, uri, nullable — Optional public image URL.
  - `startsAt` string, date-time, nullable — Optional start time in ISO 8601 with an explicit UTC offset.
  - `status` 'draft' | 'scheduled' | 'live' | 'ended' — Desired lifecycle state.
  - `title` string — Public drop title.

## Response `200`

The updated public drop.

- object
  - `drop` object, required — A single public drop with its lifecycle state and RSVP count. Timestamps are ISO 8601 strings, unlike the epoch milliseconds on Drop.
    - `createdAt` string, date-time, required — When the drop was created, in ISO 8601 with an explicit UTC offset.
    - `description` string, nullable, required — Public drop description.
    - `endAt` string, date-time, nullable — Optional drop end time in ISO 8601 with an explicit UTC offset.
    - `id` string, required — Opaque Laylo drop identifier.
    - `imageUrl` string, uri, nullable — Optional public image URL.
    - `rsvpCount` integer — Number of confirmed RSVPs.
    - `startsAt` string, date-time, nullable — Optional drop start time in ISO 8601 with an explicit UTC offset.
    - `status` 'draft' | 'scheduled' | 'live' | 'ended', required — Current public lifecycle state.
    - `title` string, required — Public drop title.
    - `updatedAt` string, date-time, required — When the drop was last updated, in ISO 8601 with an explicit UTC offset.

## Other responses

- `400` — The request body is malformed.
- `401` — The integrator credential or customer API key is invalid.
- `403` — The customer account behind the API key has no paid Laylo plan.
- `404` — No route matches the requested path.
- `405` — The path exists, but the HTTP method is not supported.
- `409` — The request conflicts with the current resource state.
- `429` — The per-integrator rate limit for this operation is exceeded.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/laylo/apis/laylo-api.md) · [All operations](https://skmtc.dev/laylo/apis/laylo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/laylo/laylo-api/revisions/000d81a01b74/schema)