Update a drop's settings
dropthis_update_settingsIdempotent
Update an existing drop's settings—title, visibility, password, noindex, expiry, metadata, and routing—using its drop ID. Content is not changed.
Instructions
Change an EXISTING drop's settings — title, visibility (public/unlisted), password, noindex, expiry, metadata, or its routing (move onto a custom domain / back to the shared pool, and rename its vanity slug) — by its drop_… id (id-only). Does not touch the content at the URL: to replace content use dropthis_update_content; to create a new drop use dropthis_publish. For a public URL or slug, call dropthis_resolve first to get the drop_… id. Idempotent — applying the same values again is a no-op.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Rename the drop's vanity slug — valid on path-mode custom domains only: 1-63 lowercase letters/digits/hyphens. A taken slug returns 409; setting one on the shared pool returns 422. | |
| title | No | New drop title. | |
| domain | No | Move the drop onto this custom domain — the hostname of a LIVE domain on this account (see dropthis_domains_list), or pass 'shared' to move it back to the shared pool. Path-mode domains serve it at https://{domain}/{slug}/; a dedicated domain serves it at the hostname root and conflicts (409) once occupied. | |
| drop_id | Yes | The `drop_…` id of the drop to update (id-only — a URL or slug is rejected; call dropthis_resolve to turn a public URL/slug into its id first). | |
| noindex | No | Prevent search-engine indexing (true), allow it (false), or null to clear. | |
| metadata | No | Arbitrary JSON key-value metadata. | |
| password | No | Set a password required to view the drop, or pass null to remove an existing one. Setting one is Pro/Business only — on Free/Keep the server returns feature_not_in_plan (403) with an upgrade_url; removing (null) is always allowed. | |
| expires_at | No | Auto-delete after this ISO 8601 timestamp (e.g. 2026-12-31T00:00:00Z), or null to clear. | |
| visibility | No | public (default) or unlisted. Unlisted is link-only: anyone with the URL can view the drop, but it is excluded from any public listing or discovery. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The drop's permanent drop_… id — persist it for every follow-up tool. | |
| url | No | The canonical, always-branded public URL (share with humans). | |
| next | No | Structured follow-up hints keyed by action. | |
| slug | No | URL slug — a locator, not an id. | |
| title | No | ||
| rawUrl | No | Raw-bytes URL for a single non-HTML file; null for HTML drops and collections. | |
| status | No | ||
| noindex | No | ||
| metadata | No | ||
| revision | No | ||
| expiresAt | No | ||
| sizeBytes | No | Total published bundle size in bytes — check before iterating on a heavy page. | |
| workspace | No | The workspace this drop belongs to {id, slug, name, kind}. | |
| visibility | No | ||
| passwordProtected | No |