Skip to content
Highlight Docs

Update edition details

PATCH
/collection/{highlightId}/details/edition

Update edition-specific details (name, description, image, animation, attributes). For a draft collection the change is saved directly. For a live collection it returns a setEditionURI transaction to sign — once confirmed on-chain, the backend re-derives the edition and refreshes every token.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
highlightId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

Request Body required

Section titled “Request Body required ”
object
edition
required
object
size
required
integer
<= 9007199254740991
name
string
>= 1 characters
description
string
>= 1 characters
imageMediaId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
animationMediaId
Any of:
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
attributes
Array<object>
object
traitType
required
string
>= 1 characters
value
required
string
>= 1 characters

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Updated edition details (draft) or a transaction to sign (live)

object
collection
required
object
highlightId
required
string
collectionId
required
Any of:
string
name
required
string
description
required
Any of:
string
logoMediaId
required
string
logoMedia
required
object
id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
accountId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
kind
required
string
Allowed values: File Directory
scope
required
string
Allowed values: Collection User
provenance
required
string
Allowed values: UserUpload SystemGenerated
status
required
string
Allowed values: Pending Processing Ready Failed
fileName
required
string
mimeType
required
Any of:
string
fileSize
required
Any of:
integer
<= 9007199254740991
contentHash
required
Any of:
string
parentId
required
Any of:
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
path
required
Any of:
string
uploadedAt
required
Any of:
string
locations
required
Array<object>
object
id
required
string
mediaId
required
string
provider
required
string
Allowed values: R2 Arweave S3 IPFS External
role
required
string
Allowed values: Origin Archive Mirror
reference
required
string
url
required
Any of:
string format: uri
status
required
string
Allowed values: Pending Succeeded Failed
attempts
required
integer
<= 9007199254740991
lastError
required
Any of:
string
syncedAt
required
Any of:
string
metadata
required
Any of:
object
key
additional properties
createdAt
required
string
updatedAt
required
string
createdAt
required
string
updatedAt
required
string
baseUriId
required
Any of:
string
royaltyAddress
required
Any of:
string
royaltyAmount
required
Any of:
integer
>= -9007199254740991 <= 9007199254740991
tokenManager
required
Any of:
string
status
required
string
Allowed values: Draft InProgress Live Migrated Disabled Archived
revealStrategy
required
string
Allowed values: Noop PreAssigned Generative
source
required
string
Allowed values: Internal External
type
required
string
Allowed values: OpenEdition LimitedEdition OneOfOne Series GenerativeSeries
contract
required
object
id
required
string
chainId
required
integer
>= -9007199254740991 <= 9007199254740991
type
required
string
Allowed values: GenerativeSeries Series MultipleEditions MultipleEditionsDFS SingleEdition SingleEditionDFS EditionsDFS1155
standard
required
string
Allowed values: ERC721 ERC1155
creatorAddress
required
string
name
required
string
address
required
Any of:
string
symbol
required
string
contractUri
required
Any of:
string
status
required
string
Allowed values: Draft Deploying Live
createdAt
required
string
updatedAt
required
string
createdAt
required
string
updatedAt
required
string
series
required
Any of:
object
size
required
integer
<= 9007199254740991
isCollectorsChoice
boolean
assetsMediaId
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
assetsMedia
Any of:
object
id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
accountId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
kind
required
string
Allowed values: File Directory
scope
required
string
Allowed values: Collection User
provenance
required
string
Allowed values: UserUpload SystemGenerated
status
required
string
Allowed values: Pending Processing Ready Failed
fileName
required
string
mimeType
required
Any of:
string
fileSize
required
Any of:
integer
<= 9007199254740991
contentHash
required
Any of:
string
parentId
required
Any of:
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
path
required
Any of:
string
uploadedAt
required
Any of:
string
locations
required
Array<object>
object
id
required
string
mediaId
required
string
provider
required
string
Allowed values: R2 Arweave S3 IPFS External
role
required
string
Allowed values: Origin Archive Mirror
reference
required
string
url
required
Any of:
string format: uri
status
required
string
Allowed values: Pending Succeeded Failed
attempts
required
integer
<= 9007199254740991
lastError
required
Any of:
string
syncedAt
required
Any of:
string
metadata
required
Any of:
object
key
additional properties
createdAt
required
string
updatedAt
required
string
createdAt
required
string
updatedAt
required
string
generative
required
Any of:
object
size
required
integer
<= 9007199254740991
codeMediaId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
codeMedia
required
object
id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
accountId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
kind
required
string
Allowed values: File Directory
scope
required
string
Allowed values: Collection User
provenance
required
string
Allowed values: UserUpload SystemGenerated
status
required
string
Allowed values: Pending Processing Ready Failed
fileName
required
string
mimeType
required
Any of:
string
fileSize
required
Any of:
integer
<= 9007199254740991
contentHash
required
Any of:
string
parentId
required
Any of:
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
path
required
Any of:
string
uploadedAt
required
Any of:
string
locations
required
Array<object>
object
id
required
string
mediaId
required
string
provider
required
string
Allowed values: R2 Arweave S3 IPFS External
role
required
string
Allowed values: Origin Archive Mirror
reference
required
string
url
required
Any of:
string format: uri
status
required
string
Allowed values: Pending Succeeded Failed
attempts
required
integer
<= 9007199254740991
lastError
required
Any of:
string
syncedAt
required
Any of:
string
metadata
required
Any of:
object
key
additional properties
createdAt
required
string
updatedAt
required
string
createdAt
required
string
updatedAt
required
string
isCurated
boolean
isGpuRendering
boolean
editionType
string
Allowed values: Limited Open
allowedHashes
Array<string>
requiredParams
Array<string>
captureSettings
object
trigger
required
string
Allowed values: Function Delay
delay
integer
> 0 <= 9007199254740991
selector
string
>= 1 characters
selectorType
string
Allowed values: SVG ELEMENT
viewPortHeight
integer
> 0 <= 9007199254740991
viewPortWidth
integer
> 0 <= 9007199254740991
edition
required
Any of:
object
editionId
required
string
size
required
integer
<= 9007199254740991
name
string
>= 1 characters
description
string
>= 1 characters
imageMediaId
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
animationMediaId
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
imageMedia
Any of:
object
id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
accountId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
kind
required
string
Allowed values: File Directory
scope
required
string
Allowed values: Collection User
provenance
required
string
Allowed values: UserUpload SystemGenerated
status
required
string
Allowed values: Pending Processing Ready Failed
fileName
required
string
mimeType
required
Any of:
string
fileSize
required
Any of:
integer
<= 9007199254740991
contentHash
required
Any of:
string
parentId
required
Any of:
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
path
required
Any of:
string
uploadedAt
required
Any of:
string
locations
required
Array<object>
object
id
required
string
mediaId
required
string
provider
required
string
Allowed values: R2 Arweave S3 IPFS External
role
required
string
Allowed values: Origin Archive Mirror
reference
required
string
url
required
Any of:
string format: uri
status
required
string
Allowed values: Pending Succeeded Failed
attempts
required
integer
<= 9007199254740991
lastError
required
Any of:
string
syncedAt
required
Any of:
string
metadata
required
Any of:
object
key
additional properties
createdAt
required
string
updatedAt
required
string
createdAt
required
string
updatedAt
required
string
animationMedia
Any of:
object
id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
accountId
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
kind
required
string
Allowed values: File Directory
scope
required
string
Allowed values: Collection User
provenance
required
string
Allowed values: UserUpload SystemGenerated
status
required
string
Allowed values: Pending Processing Ready Failed
fileName
required
string
mimeType
required
Any of:
string
fileSize
required
Any of:
integer
<= 9007199254740991
contentHash
required
Any of:
string
parentId
required
Any of:
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
path
required
Any of:
string
uploadedAt
required
Any of:
string
locations
required
Array<object>
object
id
required
string
mediaId
required
string
provider
required
string
Allowed values: R2 Arweave S3 IPFS External
role
required
string
Allowed values: Origin Archive Mirror
reference
required
string
url
required
Any of:
string format: uri
status
required
string
Allowed values: Pending Succeeded Failed
attempts
required
integer
<= 9007199254740991
lastError
required
Any of:
string
syncedAt
required
Any of:
string
metadata
required
Any of:
object
key
additional properties
createdAt
required
string
updatedAt
required
string
createdAt
required
string
updatedAt
required
string
attributes
Array<object>
object
traitType
required
string
>= 1 characters
value
required
string
>= 1 characters
account
required
object
id
required
string
displayName
required
Any of:
string
primaryAddress
required
Any of:
string
ensName
required
Any of:
string
stats
required
Any of:
object
ownerCount
required
integer
<= 9007199254740991
tokenCount
required
integer
<= 9007199254740991
volumeByCurrency
required
Array<object>
object
currency
required
string
volume
required
string
updatedAt
required
string
sales
required
Array<object>
object
id
required
string
collectionId
required
string
name
required
Any of:
string
type
required
string
Allowed values: FIXED_PRICE DUTCH_AUCTION RANKED_AUCTION ENGLISH_AUCTION CUSTOM
startAt
required
string
endAt
required
Any of:
string
price
required
string
currency
required
string
maxPerTransaction
required
integer
>= -9007199254740991 <= 9007199254740991
maxPerWallet
required
integer
>= -9007199254740991 <= 9007199254740991
maxTotal
required
integer
>= -9007199254740991 <= 9007199254740991
paymentRecipient
required
string
accessMode
required
string
Allowed values: PUBLIC GATED
gateId
required
Any of:
string
gasSponsored
required
boolean
status
required
string
Allowed values: Draft Live
paused
required
boolean
mechanicId
required
Any of:
string
typeConfig
required
Any of:
vectorId
required
Any of:
string
customMintFee
required
Any of:
string
collectorMessage
required
Any of:
string
createdAt
required
string
updatedAt
required
string
stats
required
Any of:
object
minted
required
integer
<= 9007199254740991
volume
required
string
currency
required
string
lifecycle
required
string
Allowed values: Scheduled Live SoldOut Ended Paused
contractExecution
required
Any of:
object
chainId
required
integer
> 0 <= 9007199254740991
to
required
Any of:
string
data
required
string
value
required
string

400

Section titled “400 ”

Invalid request

401

Section titled “401 ”

Unauthorized

403

Section titled “403 ”

Forbidden

404

Section titled “404 ”

Not found

503

Section titled “503 ”

Metadata archive provider unavailable