OPopensea
Drops Endpoints

Update drop item

Changed on

Saves new metadata for one existing item and returns the updated item. It returns no transaction. A token id that does not exist on the drop returns 404.

On an ERC-721 SeaDrop V1 drop that is already revealed, it also regenerates the drop's metadata on IPFS and saves the new base URI to the draft; publish with POST /api/v2/drops/{slug}/publish to put it onchain. Before reveal, the change is held until POST /api/v2/drops/{slug}/metadata/ipfs runs.

On an ERC-1155 self-mint drop, the change does not reach the contract. Use PUT /api/v2/drops/{slug}/items/{token_id} instead: it makes the same change and returns the transaction that puts it onchain.

patch/api/v2/drops/{slug}/items/{token_id}

Request

Path parameters

slugstring required

Collection slug

token_idstring required

Drop item token id

Request body

animation_urlstring

Animated media for the item, alongside its image. Omit to leave the stored value alone; send an empty string to remove it.

descriptionstring

Item description

external_urlstring

External URL

media_tokenstring required

Media token reference

namestring required

Item name

Response

Drop item updated successfully

animation_urlstring nullable

Animated media for the item, alongside its image

chainstring required

Chain identifier

contract_addressstring required

Contract address

contract_standardstring required

Contract standard

descriptionstring nullable

Item description

external_urlstring nullable

External URL

image_urlstring required

Item image URL

media_tokenstring required

Image media token

namestring nullable

Item name

token_idstring required

Token ID

Changes

  • 2c7935d84f90Revision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • info

      added the new optional request property

    • info

      added the media type */* for the response with the status

    • info

      added the media type */* for the response with the status

    • info

      added the media type */* for the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status