Edit a drop
Changes a drop's name, description, price or who can buy it — the same edit the dashboard allows. Send only what changes; `null` clears name or description.
/api/external/v1/drops/{id}also served at /api/external/drops/{id}NewChanges a drop's name, description, price or who can buy it — the same edit the dashboard allows. Send only what changes; null clears name or description.
Price is USD dollars: 0 (free) or between $5 and $750; a new price applies to future purchases only. Subscriber gating (SUBS_FREE, SUBS_ONLY_PAID) needs an active subscription tier. Name and description run the prohibited-word filter. The media of a drop cannot change — create a new drop instead.
Authentication
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
For a creator you manage or onboarded
PATCH /api/external/v1/creators/{creatorId}/drops/{id} — an agency's own key for a creator or AI persona it manages (needs canManageDrops), or your app owner's own key for an account your app onboarded. The X-Dropfans-Account header still works but is deprecated. See Acting for a creator.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The product (drop) id. |
Request body
Content type: application/json
| Name | Type | Required | Description |
|---|---|---|---|
name | string | null | Optional | Drop title, shown at checkout (cut at 200 characters). Max length: 200 |
description | string | null | Optional | Drop description (cut at 5,000 characters). Unlike create-drop, this one is stored. Max length: 5000 |
price | number | Optional | USD dollars. 0 = free; otherwise $5–$750. Rounded to cents. Min: 0 Max: 750 |
accessMode | string | Optional | OPEN = anyone can buy; SUBS_FREE = free for subscribers; SUBS_ONLY_PAID = only subscribers can buy.One of: OPEN, SUBS_FREE, SUBS_ONLY_PAID |
{
"name": "Beach set — 8 photos",
"price": 30
}Responses
| Name | Type | Description |
|---|---|---|
id | string | The product (drop) id. |
name | string | null | Drop title. |
description | string | null | Drop description. |
price | number | USD **dollars**. 0 means free. |
accessMode | string | Who can buy. One of: OPEN, SUBS_FREE, SUBS_ONLY_PAID |
moderationStatus | string | Same value as status.One of: PENDING, APPROVED, REJECTED, FLAGGED |
currency | string | Always "USD". One of: USD |
status | string | The drop’s moderation status. One of: PENDING, APPROVED, REJECTED, FLAGGED |
buyUrl | string | With an app key: your app’s plain buy link id (/buy/{linkId}) — created by POST /drops; reads return it when it exists, else /buy/{productId} (a drop your app created still counts for it). With a personal key: /buy/{productId}. For a per-fan reference, create a link with POST /api/external/v1/links.Format: uri |
linkId | string | null | The link id in buyUrl (app keys only); comes back as linkId on the sale. |
{
"id": "clxdr0p000001prod",
"name": "Beach set — 8 photos",
"description": null,
"price": 30,
"accessMode": "OPEN",
"moderationStatus": "APPROVED",
"currency": "USD",
"status": "APPROVED",
"buyUrl": "https://www.dropfans.io/buy/clxdr0p000001prod"
}Errors
| Status | Body | When |
|---|---|---|
| 400 | {"error":"price must be a number in USD (0 = free)"} | `price` not a number or negative. |
| 400 | {"error":"The minimum price is $5. Set the price to free or at least $5."} | Priced above 0 but below $5. |
| 400 | {"error":"The maximum price on Dropfans is $750. To request an increase, contact support@dropfans.io."} | Priced above $750. |
| 400 | {"error":"accessMode must be one of OPEN, SUBS_FREE, SUBS_ONLY_PAID"} | Unknown accessMode. |
| 400 | {"error":"Configure an active subscription tier before gating drops to subscribers.","code":"no_active_tier"} | Subscriber gating without an active tier. |
| 400 | {"error":"name must be a string"} | `name` or `description` is not a string or null. |
| 400 | {"error":"Field \"name\" contains a prohibited word: \"…\"","field":"name"} | Name or description tripped the word filter. |
| 400 | {"error":"Invalid JSON body"} | The body is not valid JSON. |
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
| 404 | {"error":"Drop not found"} | No such drop on this account (another creator’s drop also 404s). |
| 400 | {"error":"X-Dropfans-Account must be an account id (from GET /api/external/agency/creators), not a username.","code":"invalid_account_header"} | `X-Dropfans-Account` is not an account id. |
| 400 | {"error":"X-Dropfans-Account names a different account than the path — send one or the other.","code":"account_mismatch"} | Called under /v1/creators/{creatorId}/ with an `X-Dropfans-Account` naming another account. |
| 403 | {"error":"This key cannot act for that account.","code":"account_not_managed"} | The creator in the path (or `X-Dropfans-Account`) is one this key cannot act for: no ACCEPTED management by your agency and not an account your app onboarded (or it no longer holds a key bound to your app), a key minted for one creator, or someone is suspended, banned or deleted. An unknown id gets the same answer. |
| 403 | {"error":"The agency does not have permission for this on that account.","code":"permission_denied","permission":"canManageDrops"} | For a managed creator: the agency lacks `canManageDrops` on that account. |
| 403 | {"error":"This app does not have the drops API category enabled. Contact support to enable it.","code":"api_category_disabled","category":"drops"} | Your app has the Drops & checkout links [API category](/developers/concepts/api-categories) switched off. |
Rate limiting
Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.
Code samples
curl -X PATCH "https://www.dropfans.io/api/external/v1/drops/$PRODUCT_ID" \
-H "Authorization: Bearer $DROPFANS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Beach set — 8 photos",
"price": 30
}'const productId = '…'; // from an earlier response
const res = await fetch(`https://www.dropfans.io/api/external/v1/drops/${productId}`, {
method: 'PATCH',
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Beach set — 8 photos",
"price": 30
}),
});
console.log(await res.json());import os
import requests
product_id = "…" # from an earlier response
res = requests.patch(
f"https://www.dropfans.io/api/external/v1/drops/{product_id}",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
json={
"name": "Beach set — 8 photos",
"price": 30,
},
)
print(res.json())Questions? support@dropfans.io