putty
API ReferenceArtifacts

Change a drop

Updates the fields named in the body and leaves the rest alone. **`supply` is not in this schema and cannot be changed.** A drop that has sold editions cannot change how many editions exist. The merged result is validated as a whole, not field by field: clearing `creatorAddress` on a drop priced above zero is refused with a 409, because a paid drop with nowhere to send the money is a checkout that takes a collector's payment and loses it. Setting `status` to `live` publishes the mint page; setting it back to `draft` unpublishes it, which is how a creator pulls a drop without deleting it.

PATCH
/creator/drops/{dropId}

Updates the fields named in the body and leaves the rest alone. supply is not in this schema and cannot be changed. A drop that has sold editions cannot change how many editions exist. The merged result is validated as a whole, not field by field: clearing creatorAddress on a drop priced above zero is refused with a 409, because a paid drop with nowhere to send the money is a checkout that takes a collector's payment and loses it. Setting status to live publishes the mint page; setting it back to draft unpublishes it, which is how a creator pulls a drop without deleting it.

Authorization

bearerAuth
AuthorizationBearer <token>

A bearer token. The Account routes accept a Privy access token; the MCP transport accepts an sk- API key issued by POST /account/api-keys.

In: header

Path Parameters

dropId*string

The drop's id. The last segment of its public mint-page URL.

Length1 <= length <= 64

Request Body

application/json

The fields to change. At least one is required.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/creator/drops/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "string",  "name": "string",  "symbol": "string",  "description": "string",  "brandKitId": "string",  "brand": {    "id": "string",    "name": "string",    "tagline": "string",    "palette": {      "property1": "string",      "property2": "string"    },    "fonts": {      "heading": {        "family": "string",        "weights": [          0        ]      },      "body": {        "family": "string",        "weights": [          0        ]      }    }  },  "imageUrl": "string",  "priceUsd": "string",  "creatorAddress": "string",  "status": "draft",  "supply": {    "supply": 0,    "minted": 0,    "remaining": 0,    "soldOut": true  },  "mintPageUrl": "string",  "createdAt": "string",  "updatedAt": "string"}

Read one drop GET

The drop's current record: its brand kit, its supply accounting, its price, and its mint page URL. A drop belonging to another creator answers with the same 404 as one that does not exist.

Delete a drop DELETE

Deletes a drop the caller owns, along with every mint recorded against it. A drop belonging to another creator answers with the same 404 as one that does not exist, so this route cannot be used to confirm a guessed id. A drop that has been minted from is usually unpublished (`PATCH` with `status: "draft"`) rather than deleted, so the mint history is not thrown away.