XRPL.to
POST /studio/drop/{slug}/manage
POST

/v1/studio/drop/{slug}/manage

Change a live drop (its creator): pause, resume, end, price, limits, whitelist, schedule, description, cover, links

AuthNone — works without a key

Payload

POSThttps://api.xrpl.to/v1/studio/drop/fuzzybears/manage
Path parameterValueDescription
slugA collection slug, or its identity as issuer:taxon
Body
Body fieldsas documented
{
  changes (a JSON object as a string: paused,
  ended,
  price_amount,
  per_wallet_limit,
  per_ip_limit,
  referral_bps,
  phases[] (a phase sent with its id keeps it,
  and without wallets keeps its list),
  whitelist[],
  mint_start,
  public_start,
  mint_end,
  description,
  image,
  links,
  edition_copies (an edition's: 0 for no limit,
  or at least what is taken),
  art ({ cid, nft? }: new art for a dynamic drop's NFTs),
  claim_code (a new one,
  or null: none),
  events[] (the whole list)),
  payment_hash?
}
curl -X POST 'https://api.xrpl.to/v1/studio/drop/fuzzybears/manage'
No public sample for this one — copy the code and fill in your own values.

Response

No public sample for this endpoint — run the code on the right with your own values to see the response.

What it does

Change a live drop (its creator): pause, resume, end, price, limits, whitelist, schedule, description, cover, links

Notes
mint_end moves the sale's end (into the future only: to stop at once, pause or end the drop) or takes it away (null); a sale that has ended opens again when its end moves later. Without payment_hash: 402 with minter_address, reveal_tag and invoice_id. The proof is a payment of at least 1 drop from the creator to minter_address with DestinationTag = reveal_tag and InvoiceID = invoice_id (SHA-256 of "<slug>:<changes>"), so it carries exactly these changes; used once. A change that would be refused is refused before any proof. ended: true ends the drop for good. events: up to 20, each { id? (kept when sent back), title (up to 100 characters), starts_at (RFC 3339), kind (online or in_person), location?, url? (https), image? (uploaded here: POST /studio/upload/raw), description?, expires_at? (RFC 3339, in the future: the event leaves the page then; null: when removed) }; GET /studio/drop/{slug} shows those not expired, soonest first. A phase sent back without wallets keeps its list and their own limits (wallet_limits). art: a new metadata file uploaded here (POST /studio/upload) for a dynamic drop's NFTs (minted with tfMutable): every copy of an edition (no nft; its next copies mint with it), or one NFT of a collection (nft: its NFTokenID). The answer's art_job (GET /studio/upload/job/{id}) follows the minter publishing it and putting it on each NFT minted so far, wherever it is now (NFTokenModify, as the issuer's authorized minter); an NFT it could not change is named in the job's error, and can be asked again.
No key. Payments on the ledger pay for what costs money; a hidden drop's art stays off IPFS until its reveal. Open the NFT studio →
OpenAPI
PrevPOST/studio/drop/{slug}/reveal