Create IP Asset
curl --request POST \
--url https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <x-api-key>' \
--data @- <<EOF
{
"derivData": {
"licenseTermsIds": [
1
],
"parentIpIds": [
"0x123"
]
},
"ipAssetMetadata": {
"attributes": [
{
"key": "ISBN",
"value": "978-0-7475-3269-0"
},
{
"key": "Genre",
"value": "Fantasy"
}
],
"createdAt": "1997-06-26T00:00:00",
"creators": [
{
"contributionPercent": 80,
"crossmintUserLocator": "email:JKRowling@example.com:story",
"description": "Author",
"email": "JKRowling@example.com",
"name": "JK Rowling",
"socialMedia": [
{
"platform": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/J._K._Rowling"
}
]
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 15,
"description": "Illustrator",
"name": "Thomas Taylor"
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 5,
"description": "Publisher",
"email": "BloomsburyPublishing@example.com",
"name": "Bloomsbury Publishing",
"socialMedia": [
{
"platform": "Website",
"url": "https://www.bloomsbury.com/"
}
]
}
],
"image": "https://example.com/book-cover.jpg",
"imageHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"ipType": "literature",
"media": [
{
"mimeType": "application/epub+zip",
"name": "ePub",
"url": "link_to_epub"
},
{
"mimeType": "application/pdf",
"name": "Book Summary PDF",
"url": "link_to_book_summary_pdf"
}
],
"mediaHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"mediaType": "application/epub+zip",
"mediaUrl": "link_to_epub",
"title": "Harry Potter and the Philosopher's Stone"
},
"nftMetadata": {
"description": "A unique story NFT",
"image": "https://example.com/nft/123.png",
"name": "Art #123"
},
"owner": "email:creator@example.com:story-testnet",
"licenseTerms": [
{
"terms": {
"commercialRevShare": 50,
"currency": "0x0000000000000000000000000000000000000000",
"defaultMintingFee": 100
},
"type": "commercial-remix"
}
],
"reuploadLinkedFiles": true,
"sendNotification": true
}
EOFimport requests
url = "https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets"
payload = {
"derivData": {
"licenseTermsIds": [1],
"parentIpIds": ["0x123"]
},
"ipAssetMetadata": {
"attributes": [
{
"key": "ISBN",
"value": "978-0-7475-3269-0"
},
{
"key": "Genre",
"value": "Fantasy"
}
],
"createdAt": "1997-06-26T00:00:00",
"creators": [
{
"contributionPercent": 80,
"crossmintUserLocator": "email:JKRowling@example.com:story",
"description": "Author",
"email": "JKRowling@example.com",
"name": "JK Rowling",
"socialMedia": [
{
"platform": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/J._K._Rowling"
}
]
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 15,
"description": "Illustrator",
"name": "Thomas Taylor"
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 5,
"description": "Publisher",
"email": "BloomsburyPublishing@example.com",
"name": "Bloomsbury Publishing",
"socialMedia": [
{
"platform": "Website",
"url": "https://www.bloomsbury.com/"
}
]
}
],
"image": "https://example.com/book-cover.jpg",
"imageHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"ipType": "literature",
"media": [
{
"mimeType": "application/epub+zip",
"name": "ePub",
"url": "link_to_epub"
},
{
"mimeType": "application/pdf",
"name": "Book Summary PDF",
"url": "link_to_book_summary_pdf"
}
],
"mediaHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"mediaType": "application/epub+zip",
"mediaUrl": "link_to_epub",
"title": "Harry Potter and the Philosopher's Stone"
},
"nftMetadata": {
"description": "A unique story NFT",
"image": "https://example.com/nft/123.png",
"name": "Art #123"
},
"owner": "email:creator@example.com:story-testnet",
"licenseTerms": [
{
"terms": {
"commercialRevShare": 50,
"currency": "0x0000000000000000000000000000000000000000",
"defaultMintingFee": 100
},
"type": "commercial-remix"
}
],
"reuploadLinkedFiles": True,
"sendNotification": True
}
headers = {
"X-API-KEY": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
derivData: {licenseTermsIds: [1], parentIpIds: ['0x123']},
ipAssetMetadata: {
attributes: [{key: 'ISBN', value: '978-0-7475-3269-0'}, {key: 'Genre', value: 'Fantasy'}],
createdAt: '1997-06-26T00:00:00',
creators: [
{
contributionPercent: 80,
crossmintUserLocator: 'email:JKRowling@example.com:story',
description: 'Author',
email: 'JKRowling@example.com',
name: 'JK Rowling',
socialMedia: [{platform: 'Wikipedia', url: 'https://en.wikipedia.org/wiki/J._K._Rowling'}]
},
{
address: '0x1234567890123456789012345678901234567890',
contributionPercent: 15,
description: 'Illustrator',
name: 'Thomas Taylor'
},
{
address: '0x1234567890123456789012345678901234567890',
contributionPercent: 5,
description: 'Publisher',
email: 'BloomsburyPublishing@example.com',
name: 'Bloomsbury Publishing',
socialMedia: [{platform: 'Website', url: 'https://www.bloomsbury.com/'}]
}
],
image: 'https://example.com/book-cover.jpg',
imageHash: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef',
ipType: 'literature',
media: [
{mimeType: 'application/epub+zip', name: 'ePub', url: 'link_to_epub'},
{
mimeType: 'application/pdf',
name: 'Book Summary PDF',
url: 'link_to_book_summary_pdf'
}
],
mediaHash: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef',
mediaType: 'application/epub+zip',
mediaUrl: 'link_to_epub',
title: 'Harry Potter and the Philosopher\'s Stone'
},
nftMetadata: {
description: 'A unique story NFT',
image: 'https://example.com/nft/123.png',
name: 'Art #123'
},
owner: 'email:creator@example.com:story-testnet',
licenseTerms: [
{
terms: {
commercialRevShare: 50,
currency: '0x0000000000000000000000000000000000000000',
defaultMintingFee: 100
},
type: 'commercial-remix'
}
],
reuploadLinkedFiles: true,
sendNotification: true
})
};
fetch('https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'derivData' => [
'licenseTermsIds' => [
1
],
'parentIpIds' => [
'0x123'
]
],
'ipAssetMetadata' => [
'attributes' => [
[
'key' => 'ISBN',
'value' => '978-0-7475-3269-0'
],
[
'key' => 'Genre',
'value' => 'Fantasy'
]
],
'createdAt' => '1997-06-26T00:00:00',
'creators' => [
[
'contributionPercent' => 80,
'crossmintUserLocator' => 'email:JKRowling@example.com:story',
'description' => 'Author',
'email' => 'JKRowling@example.com',
'name' => 'JK Rowling',
'socialMedia' => [
[
'platform' => 'Wikipedia',
'url' => 'https://en.wikipedia.org/wiki/J._K._Rowling'
]
]
],
[
'address' => '0x1234567890123456789012345678901234567890',
'contributionPercent' => 15,
'description' => 'Illustrator',
'name' => 'Thomas Taylor'
],
[
'address' => '0x1234567890123456789012345678901234567890',
'contributionPercent' => 5,
'description' => 'Publisher',
'email' => 'BloomsburyPublishing@example.com',
'name' => 'Bloomsbury Publishing',
'socialMedia' => [
[
'platform' => 'Website',
'url' => 'https://www.bloomsbury.com/'
]
]
]
],
'image' => 'https://example.com/book-cover.jpg',
'imageHash' => '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef',
'ipType' => 'literature',
'media' => [
[
'mimeType' => 'application/epub+zip',
'name' => 'ePub',
'url' => 'link_to_epub'
],
[
'mimeType' => 'application/pdf',
'name' => 'Book Summary PDF',
'url' => 'link_to_book_summary_pdf'
]
],
'mediaHash' => '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef',
'mediaType' => 'application/epub+zip',
'mediaUrl' => 'link_to_epub',
'title' => 'Harry Potter and the Philosopher\'s Stone'
],
'nftMetadata' => [
'description' => 'A unique story NFT',
'image' => 'https://example.com/nft/123.png',
'name' => 'Art #123'
],
'owner' => 'email:creator@example.com:story-testnet',
'licenseTerms' => [
[
'terms' => [
'commercialRevShare' => 50,
'currency' => '0x0000000000000000000000000000000000000000',
'defaultMintingFee' => 100
],
'type' => 'commercial-remix'
]
],
'reuploadLinkedFiles' => true,
'sendNotification' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets"
payload := strings.NewReader("{\n \"derivData\": {\n \"licenseTermsIds\": [\n 1\n ],\n \"parentIpIds\": [\n \"0x123\"\n ]\n },\n \"ipAssetMetadata\": {\n \"attributes\": [\n {\n \"key\": \"ISBN\",\n \"value\": \"978-0-7475-3269-0\"\n },\n {\n \"key\": \"Genre\",\n \"value\": \"Fantasy\"\n }\n ],\n \"createdAt\": \"1997-06-26T00:00:00\",\n \"creators\": [\n {\n \"contributionPercent\": 80,\n \"crossmintUserLocator\": \"email:JKRowling@example.com:story\",\n \"description\": \"Author\",\n \"email\": \"JKRowling@example.com\",\n \"name\": \"JK Rowling\",\n \"socialMedia\": [\n {\n \"platform\": \"Wikipedia\",\n \"url\": \"https://en.wikipedia.org/wiki/J._K._Rowling\"\n }\n ]\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 15,\n \"description\": \"Illustrator\",\n \"name\": \"Thomas Taylor\"\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 5,\n \"description\": \"Publisher\",\n \"email\": \"BloomsburyPublishing@example.com\",\n \"name\": \"Bloomsbury Publishing\",\n \"socialMedia\": [\n {\n \"platform\": \"Website\",\n \"url\": \"https://www.bloomsbury.com/\"\n }\n ]\n }\n ],\n \"image\": \"https://example.com/book-cover.jpg\",\n \"imageHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"ipType\": \"literature\",\n \"media\": [\n {\n \"mimeType\": \"application/epub+zip\",\n \"name\": \"ePub\",\n \"url\": \"link_to_epub\"\n },\n {\n \"mimeType\": \"application/pdf\",\n \"name\": \"Book Summary PDF\",\n \"url\": \"link_to_book_summary_pdf\"\n }\n ],\n \"mediaHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"mediaType\": \"application/epub+zip\",\n \"mediaUrl\": \"link_to_epub\",\n \"title\": \"Harry Potter and the Philosopher's Stone\"\n },\n \"nftMetadata\": {\n \"description\": \"A unique story NFT\",\n \"image\": \"https://example.com/nft/123.png\",\n \"name\": \"Art #123\"\n },\n \"owner\": \"email:creator@example.com:story-testnet\",\n \"licenseTerms\": [\n {\n \"terms\": {\n \"commercialRevShare\": 50,\n \"currency\": \"0x0000000000000000000000000000000000000000\",\n \"defaultMintingFee\": 100\n },\n \"type\": \"commercial-remix\"\n }\n ],\n \"reuploadLinkedFiles\": true,\n \"sendNotification\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets")
.header("X-API-KEY", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"derivData\": {\n \"licenseTermsIds\": [\n 1\n ],\n \"parentIpIds\": [\n \"0x123\"\n ]\n },\n \"ipAssetMetadata\": {\n \"attributes\": [\n {\n \"key\": \"ISBN\",\n \"value\": \"978-0-7475-3269-0\"\n },\n {\n \"key\": \"Genre\",\n \"value\": \"Fantasy\"\n }\n ],\n \"createdAt\": \"1997-06-26T00:00:00\",\n \"creators\": [\n {\n \"contributionPercent\": 80,\n \"crossmintUserLocator\": \"email:JKRowling@example.com:story\",\n \"description\": \"Author\",\n \"email\": \"JKRowling@example.com\",\n \"name\": \"JK Rowling\",\n \"socialMedia\": [\n {\n \"platform\": \"Wikipedia\",\n \"url\": \"https://en.wikipedia.org/wiki/J._K._Rowling\"\n }\n ]\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 15,\n \"description\": \"Illustrator\",\n \"name\": \"Thomas Taylor\"\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 5,\n \"description\": \"Publisher\",\n \"email\": \"BloomsburyPublishing@example.com\",\n \"name\": \"Bloomsbury Publishing\",\n \"socialMedia\": [\n {\n \"platform\": \"Website\",\n \"url\": \"https://www.bloomsbury.com/\"\n }\n ]\n }\n ],\n \"image\": \"https://example.com/book-cover.jpg\",\n \"imageHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"ipType\": \"literature\",\n \"media\": [\n {\n \"mimeType\": \"application/epub+zip\",\n \"name\": \"ePub\",\n \"url\": \"link_to_epub\"\n },\n {\n \"mimeType\": \"application/pdf\",\n \"name\": \"Book Summary PDF\",\n \"url\": \"link_to_book_summary_pdf\"\n }\n ],\n \"mediaHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"mediaType\": \"application/epub+zip\",\n \"mediaUrl\": \"link_to_epub\",\n \"title\": \"Harry Potter and the Philosopher's Stone\"\n },\n \"nftMetadata\": {\n \"description\": \"A unique story NFT\",\n \"image\": \"https://example.com/nft/123.png\",\n \"name\": \"Art #123\"\n },\n \"owner\": \"email:creator@example.com:story-testnet\",\n \"licenseTerms\": [\n {\n \"terms\": {\n \"commercialRevShare\": 50,\n \"currency\": \"0x0000000000000000000000000000000000000000\",\n \"defaultMintingFee\": 100\n },\n \"type\": \"commercial-remix\"\n }\n ],\n \"reuploadLinkedFiles\": true,\n \"sendNotification\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"derivData\": {\n \"licenseTermsIds\": [\n 1\n ],\n \"parentIpIds\": [\n \"0x123\"\n ]\n },\n \"ipAssetMetadata\": {\n \"attributes\": [\n {\n \"key\": \"ISBN\",\n \"value\": \"978-0-7475-3269-0\"\n },\n {\n \"key\": \"Genre\",\n \"value\": \"Fantasy\"\n }\n ],\n \"createdAt\": \"1997-06-26T00:00:00\",\n \"creators\": [\n {\n \"contributionPercent\": 80,\n \"crossmintUserLocator\": \"email:JKRowling@example.com:story\",\n \"description\": \"Author\",\n \"email\": \"JKRowling@example.com\",\n \"name\": \"JK Rowling\",\n \"socialMedia\": [\n {\n \"platform\": \"Wikipedia\",\n \"url\": \"https://en.wikipedia.org/wiki/J._K._Rowling\"\n }\n ]\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 15,\n \"description\": \"Illustrator\",\n \"name\": \"Thomas Taylor\"\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 5,\n \"description\": \"Publisher\",\n \"email\": \"BloomsburyPublishing@example.com\",\n \"name\": \"Bloomsbury Publishing\",\n \"socialMedia\": [\n {\n \"platform\": \"Website\",\n \"url\": \"https://www.bloomsbury.com/\"\n }\n ]\n }\n ],\n \"image\": \"https://example.com/book-cover.jpg\",\n \"imageHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"ipType\": \"literature\",\n \"media\": [\n {\n \"mimeType\": \"application/epub+zip\",\n \"name\": \"ePub\",\n \"url\": \"link_to_epub\"\n },\n {\n \"mimeType\": \"application/pdf\",\n \"name\": \"Book Summary PDF\",\n \"url\": \"link_to_book_summary_pdf\"\n }\n ],\n \"mediaHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"mediaType\": \"application/epub+zip\",\n \"mediaUrl\": \"link_to_epub\",\n \"title\": \"Harry Potter and the Philosopher's Stone\"\n },\n \"nftMetadata\": {\n \"description\": \"A unique story NFT\",\n \"image\": \"https://example.com/nft/123.png\",\n \"name\": \"Art #123\"\n },\n \"owner\": \"email:creator@example.com:story-testnet\",\n \"licenseTerms\": [\n {\n \"terms\": {\n \"commercialRevShare\": 50,\n \"currency\": \"0x0000000000000000000000000000000000000000\",\n \"defaultMintingFee\": 100\n },\n \"type\": \"commercial-remix\"\n }\n ],\n \"reuploadLinkedFiles\": true,\n \"sendNotification\": true\n}"
response = http.request(request)
puts response.read_body{
"actionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"derivData": {
"licenseTermsIds": [
1
],
"maxMintingFee": 0,
"maxRevenueShare": 100,
"maxRts": 10000000,
"parentIpIds": [
"0x123"
]
},
"id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"ipAssetMetadata": {
"attributes": [
{
"key": "ISBN",
"value": "978-0-7475-3269-0"
},
{
"key": "Genre",
"value": "Fantasy"
}
],
"createdAt": "1997-06-26T00:00:00",
"creators": [
{
"contributionPercent": 80,
"crossmintUserLocator": "email:JKRowling@example.com:story",
"description": "Author",
"email": "JKRowling@example.com",
"name": "JK Rowling",
"socialMedia": [
{
"platform": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/J._K._Rowling"
}
]
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 15,
"description": "Illustrator",
"name": "Thomas Taylor"
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 5,
"description": "Publisher",
"email": "BloomsburyPublishing@example.com",
"name": "Bloomsbury Publishing",
"socialMedia": [
{
"platform": "Website",
"url": "https://www.bloomsbury.com/"
}
]
}
],
"image": "https://example.com/book-cover.jpg",
"imageHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"ipType": "literature",
"media": [
{
"mimeType": "application/epub+zip",
"name": "ePub",
"url": "link_to_epub"
},
{
"mimeType": "application/pdf",
"name": "Book Summary PDF",
"url": "link_to_book_summary_pdf"
}
],
"mediaHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"mediaType": "application/epub+zip",
"mediaUrl": "link_to_epub",
"title": "Harry Potter and the Philosopher's Stone"
},
"nftMetadata": {
"description": "A unique story NFT",
"image": "https://example.com/nft/123.png",
"name": "Art #123"
},
"onChain": {
"chain": "story-testnet",
"contractAddress": "0x123",
"status": "pending"
},
"licenseTerms": [
{
"terms": {
"commercialRevShare": 50,
"currency": "0x0000000000000000000000000000000000000000",
"defaultMintingFee": 100
},
"type": "commercial-remix"
}
]
}IP Assets
Create IP Asset
Create a new IP Asset
API scope required: nfts.create
POST
/
v1
/
ip
/
collections
/
{collectionId}
/
ipassets
Create IP Asset
curl --request POST \
--url https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <x-api-key>' \
--data @- <<EOF
{
"derivData": {
"licenseTermsIds": [
1
],
"parentIpIds": [
"0x123"
]
},
"ipAssetMetadata": {
"attributes": [
{
"key": "ISBN",
"value": "978-0-7475-3269-0"
},
{
"key": "Genre",
"value": "Fantasy"
}
],
"createdAt": "1997-06-26T00:00:00",
"creators": [
{
"contributionPercent": 80,
"crossmintUserLocator": "email:JKRowling@example.com:story",
"description": "Author",
"email": "JKRowling@example.com",
"name": "JK Rowling",
"socialMedia": [
{
"platform": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/J._K._Rowling"
}
]
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 15,
"description": "Illustrator",
"name": "Thomas Taylor"
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 5,
"description": "Publisher",
"email": "BloomsburyPublishing@example.com",
"name": "Bloomsbury Publishing",
"socialMedia": [
{
"platform": "Website",
"url": "https://www.bloomsbury.com/"
}
]
}
],
"image": "https://example.com/book-cover.jpg",
"imageHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"ipType": "literature",
"media": [
{
"mimeType": "application/epub+zip",
"name": "ePub",
"url": "link_to_epub"
},
{
"mimeType": "application/pdf",
"name": "Book Summary PDF",
"url": "link_to_book_summary_pdf"
}
],
"mediaHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"mediaType": "application/epub+zip",
"mediaUrl": "link_to_epub",
"title": "Harry Potter and the Philosopher's Stone"
},
"nftMetadata": {
"description": "A unique story NFT",
"image": "https://example.com/nft/123.png",
"name": "Art #123"
},
"owner": "email:creator@example.com:story-testnet",
"licenseTerms": [
{
"terms": {
"commercialRevShare": 50,
"currency": "0x0000000000000000000000000000000000000000",
"defaultMintingFee": 100
},
"type": "commercial-remix"
}
],
"reuploadLinkedFiles": true,
"sendNotification": true
}
EOFimport requests
url = "https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets"
payload = {
"derivData": {
"licenseTermsIds": [1],
"parentIpIds": ["0x123"]
},
"ipAssetMetadata": {
"attributes": [
{
"key": "ISBN",
"value": "978-0-7475-3269-0"
},
{
"key": "Genre",
"value": "Fantasy"
}
],
"createdAt": "1997-06-26T00:00:00",
"creators": [
{
"contributionPercent": 80,
"crossmintUserLocator": "email:JKRowling@example.com:story",
"description": "Author",
"email": "JKRowling@example.com",
"name": "JK Rowling",
"socialMedia": [
{
"platform": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/J._K._Rowling"
}
]
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 15,
"description": "Illustrator",
"name": "Thomas Taylor"
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 5,
"description": "Publisher",
"email": "BloomsburyPublishing@example.com",
"name": "Bloomsbury Publishing",
"socialMedia": [
{
"platform": "Website",
"url": "https://www.bloomsbury.com/"
}
]
}
],
"image": "https://example.com/book-cover.jpg",
"imageHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"ipType": "literature",
"media": [
{
"mimeType": "application/epub+zip",
"name": "ePub",
"url": "link_to_epub"
},
{
"mimeType": "application/pdf",
"name": "Book Summary PDF",
"url": "link_to_book_summary_pdf"
}
],
"mediaHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"mediaType": "application/epub+zip",
"mediaUrl": "link_to_epub",
"title": "Harry Potter and the Philosopher's Stone"
},
"nftMetadata": {
"description": "A unique story NFT",
"image": "https://example.com/nft/123.png",
"name": "Art #123"
},
"owner": "email:creator@example.com:story-testnet",
"licenseTerms": [
{
"terms": {
"commercialRevShare": 50,
"currency": "0x0000000000000000000000000000000000000000",
"defaultMintingFee": 100
},
"type": "commercial-remix"
}
],
"reuploadLinkedFiles": True,
"sendNotification": True
}
headers = {
"X-API-KEY": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
derivData: {licenseTermsIds: [1], parentIpIds: ['0x123']},
ipAssetMetadata: {
attributes: [{key: 'ISBN', value: '978-0-7475-3269-0'}, {key: 'Genre', value: 'Fantasy'}],
createdAt: '1997-06-26T00:00:00',
creators: [
{
contributionPercent: 80,
crossmintUserLocator: 'email:JKRowling@example.com:story',
description: 'Author',
email: 'JKRowling@example.com',
name: 'JK Rowling',
socialMedia: [{platform: 'Wikipedia', url: 'https://en.wikipedia.org/wiki/J._K._Rowling'}]
},
{
address: '0x1234567890123456789012345678901234567890',
contributionPercent: 15,
description: 'Illustrator',
name: 'Thomas Taylor'
},
{
address: '0x1234567890123456789012345678901234567890',
contributionPercent: 5,
description: 'Publisher',
email: 'BloomsburyPublishing@example.com',
name: 'Bloomsbury Publishing',
socialMedia: [{platform: 'Website', url: 'https://www.bloomsbury.com/'}]
}
],
image: 'https://example.com/book-cover.jpg',
imageHash: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef',
ipType: 'literature',
media: [
{mimeType: 'application/epub+zip', name: 'ePub', url: 'link_to_epub'},
{
mimeType: 'application/pdf',
name: 'Book Summary PDF',
url: 'link_to_book_summary_pdf'
}
],
mediaHash: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef',
mediaType: 'application/epub+zip',
mediaUrl: 'link_to_epub',
title: 'Harry Potter and the Philosopher\'s Stone'
},
nftMetadata: {
description: 'A unique story NFT',
image: 'https://example.com/nft/123.png',
name: 'Art #123'
},
owner: 'email:creator@example.com:story-testnet',
licenseTerms: [
{
terms: {
commercialRevShare: 50,
currency: '0x0000000000000000000000000000000000000000',
defaultMintingFee: 100
},
type: 'commercial-remix'
}
],
reuploadLinkedFiles: true,
sendNotification: true
})
};
fetch('https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'derivData' => [
'licenseTermsIds' => [
1
],
'parentIpIds' => [
'0x123'
]
],
'ipAssetMetadata' => [
'attributes' => [
[
'key' => 'ISBN',
'value' => '978-0-7475-3269-0'
],
[
'key' => 'Genre',
'value' => 'Fantasy'
]
],
'createdAt' => '1997-06-26T00:00:00',
'creators' => [
[
'contributionPercent' => 80,
'crossmintUserLocator' => 'email:JKRowling@example.com:story',
'description' => 'Author',
'email' => 'JKRowling@example.com',
'name' => 'JK Rowling',
'socialMedia' => [
[
'platform' => 'Wikipedia',
'url' => 'https://en.wikipedia.org/wiki/J._K._Rowling'
]
]
],
[
'address' => '0x1234567890123456789012345678901234567890',
'contributionPercent' => 15,
'description' => 'Illustrator',
'name' => 'Thomas Taylor'
],
[
'address' => '0x1234567890123456789012345678901234567890',
'contributionPercent' => 5,
'description' => 'Publisher',
'email' => 'BloomsburyPublishing@example.com',
'name' => 'Bloomsbury Publishing',
'socialMedia' => [
[
'platform' => 'Website',
'url' => 'https://www.bloomsbury.com/'
]
]
]
],
'image' => 'https://example.com/book-cover.jpg',
'imageHash' => '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef',
'ipType' => 'literature',
'media' => [
[
'mimeType' => 'application/epub+zip',
'name' => 'ePub',
'url' => 'link_to_epub'
],
[
'mimeType' => 'application/pdf',
'name' => 'Book Summary PDF',
'url' => 'link_to_book_summary_pdf'
]
],
'mediaHash' => '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef',
'mediaType' => 'application/epub+zip',
'mediaUrl' => 'link_to_epub',
'title' => 'Harry Potter and the Philosopher\'s Stone'
],
'nftMetadata' => [
'description' => 'A unique story NFT',
'image' => 'https://example.com/nft/123.png',
'name' => 'Art #123'
],
'owner' => 'email:creator@example.com:story-testnet',
'licenseTerms' => [
[
'terms' => [
'commercialRevShare' => 50,
'currency' => '0x0000000000000000000000000000000000000000',
'defaultMintingFee' => 100
],
'type' => 'commercial-remix'
]
],
'reuploadLinkedFiles' => true,
'sendNotification' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets"
payload := strings.NewReader("{\n \"derivData\": {\n \"licenseTermsIds\": [\n 1\n ],\n \"parentIpIds\": [\n \"0x123\"\n ]\n },\n \"ipAssetMetadata\": {\n \"attributes\": [\n {\n \"key\": \"ISBN\",\n \"value\": \"978-0-7475-3269-0\"\n },\n {\n \"key\": \"Genre\",\n \"value\": \"Fantasy\"\n }\n ],\n \"createdAt\": \"1997-06-26T00:00:00\",\n \"creators\": [\n {\n \"contributionPercent\": 80,\n \"crossmintUserLocator\": \"email:JKRowling@example.com:story\",\n \"description\": \"Author\",\n \"email\": \"JKRowling@example.com\",\n \"name\": \"JK Rowling\",\n \"socialMedia\": [\n {\n \"platform\": \"Wikipedia\",\n \"url\": \"https://en.wikipedia.org/wiki/J._K._Rowling\"\n }\n ]\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 15,\n \"description\": \"Illustrator\",\n \"name\": \"Thomas Taylor\"\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 5,\n \"description\": \"Publisher\",\n \"email\": \"BloomsburyPublishing@example.com\",\n \"name\": \"Bloomsbury Publishing\",\n \"socialMedia\": [\n {\n \"platform\": \"Website\",\n \"url\": \"https://www.bloomsbury.com/\"\n }\n ]\n }\n ],\n \"image\": \"https://example.com/book-cover.jpg\",\n \"imageHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"ipType\": \"literature\",\n \"media\": [\n {\n \"mimeType\": \"application/epub+zip\",\n \"name\": \"ePub\",\n \"url\": \"link_to_epub\"\n },\n {\n \"mimeType\": \"application/pdf\",\n \"name\": \"Book Summary PDF\",\n \"url\": \"link_to_book_summary_pdf\"\n }\n ],\n \"mediaHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"mediaType\": \"application/epub+zip\",\n \"mediaUrl\": \"link_to_epub\",\n \"title\": \"Harry Potter and the Philosopher's Stone\"\n },\n \"nftMetadata\": {\n \"description\": \"A unique story NFT\",\n \"image\": \"https://example.com/nft/123.png\",\n \"name\": \"Art #123\"\n },\n \"owner\": \"email:creator@example.com:story-testnet\",\n \"licenseTerms\": [\n {\n \"terms\": {\n \"commercialRevShare\": 50,\n \"currency\": \"0x0000000000000000000000000000000000000000\",\n \"defaultMintingFee\": 100\n },\n \"type\": \"commercial-remix\"\n }\n ],\n \"reuploadLinkedFiles\": true,\n \"sendNotification\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets")
.header("X-API-KEY", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"derivData\": {\n \"licenseTermsIds\": [\n 1\n ],\n \"parentIpIds\": [\n \"0x123\"\n ]\n },\n \"ipAssetMetadata\": {\n \"attributes\": [\n {\n \"key\": \"ISBN\",\n \"value\": \"978-0-7475-3269-0\"\n },\n {\n \"key\": \"Genre\",\n \"value\": \"Fantasy\"\n }\n ],\n \"createdAt\": \"1997-06-26T00:00:00\",\n \"creators\": [\n {\n \"contributionPercent\": 80,\n \"crossmintUserLocator\": \"email:JKRowling@example.com:story\",\n \"description\": \"Author\",\n \"email\": \"JKRowling@example.com\",\n \"name\": \"JK Rowling\",\n \"socialMedia\": [\n {\n \"platform\": \"Wikipedia\",\n \"url\": \"https://en.wikipedia.org/wiki/J._K._Rowling\"\n }\n ]\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 15,\n \"description\": \"Illustrator\",\n \"name\": \"Thomas Taylor\"\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 5,\n \"description\": \"Publisher\",\n \"email\": \"BloomsburyPublishing@example.com\",\n \"name\": \"Bloomsbury Publishing\",\n \"socialMedia\": [\n {\n \"platform\": \"Website\",\n \"url\": \"https://www.bloomsbury.com/\"\n }\n ]\n }\n ],\n \"image\": \"https://example.com/book-cover.jpg\",\n \"imageHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"ipType\": \"literature\",\n \"media\": [\n {\n \"mimeType\": \"application/epub+zip\",\n \"name\": \"ePub\",\n \"url\": \"link_to_epub\"\n },\n {\n \"mimeType\": \"application/pdf\",\n \"name\": \"Book Summary PDF\",\n \"url\": \"link_to_book_summary_pdf\"\n }\n ],\n \"mediaHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"mediaType\": \"application/epub+zip\",\n \"mediaUrl\": \"link_to_epub\",\n \"title\": \"Harry Potter and the Philosopher's Stone\"\n },\n \"nftMetadata\": {\n \"description\": \"A unique story NFT\",\n \"image\": \"https://example.com/nft/123.png\",\n \"name\": \"Art #123\"\n },\n \"owner\": \"email:creator@example.com:story-testnet\",\n \"licenseTerms\": [\n {\n \"terms\": {\n \"commercialRevShare\": 50,\n \"currency\": \"0x0000000000000000000000000000000000000000\",\n \"defaultMintingFee\": 100\n },\n \"type\": \"commercial-remix\"\n }\n ],\n \"reuploadLinkedFiles\": true,\n \"sendNotification\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging.crossmint.com/api/v1/ip/collections/{collectionId}/ipassets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"derivData\": {\n \"licenseTermsIds\": [\n 1\n ],\n \"parentIpIds\": [\n \"0x123\"\n ]\n },\n \"ipAssetMetadata\": {\n \"attributes\": [\n {\n \"key\": \"ISBN\",\n \"value\": \"978-0-7475-3269-0\"\n },\n {\n \"key\": \"Genre\",\n \"value\": \"Fantasy\"\n }\n ],\n \"createdAt\": \"1997-06-26T00:00:00\",\n \"creators\": [\n {\n \"contributionPercent\": 80,\n \"crossmintUserLocator\": \"email:JKRowling@example.com:story\",\n \"description\": \"Author\",\n \"email\": \"JKRowling@example.com\",\n \"name\": \"JK Rowling\",\n \"socialMedia\": [\n {\n \"platform\": \"Wikipedia\",\n \"url\": \"https://en.wikipedia.org/wiki/J._K._Rowling\"\n }\n ]\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 15,\n \"description\": \"Illustrator\",\n \"name\": \"Thomas Taylor\"\n },\n {\n \"address\": \"0x1234567890123456789012345678901234567890\",\n \"contributionPercent\": 5,\n \"description\": \"Publisher\",\n \"email\": \"BloomsburyPublishing@example.com\",\n \"name\": \"Bloomsbury Publishing\",\n \"socialMedia\": [\n {\n \"platform\": \"Website\",\n \"url\": \"https://www.bloomsbury.com/\"\n }\n ]\n }\n ],\n \"image\": \"https://example.com/book-cover.jpg\",\n \"imageHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"ipType\": \"literature\",\n \"media\": [\n {\n \"mimeType\": \"application/epub+zip\",\n \"name\": \"ePub\",\n \"url\": \"link_to_epub\"\n },\n {\n \"mimeType\": \"application/pdf\",\n \"name\": \"Book Summary PDF\",\n \"url\": \"link_to_book_summary_pdf\"\n }\n ],\n \"mediaHash\": \"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n \"mediaType\": \"application/epub+zip\",\n \"mediaUrl\": \"link_to_epub\",\n \"title\": \"Harry Potter and the Philosopher's Stone\"\n },\n \"nftMetadata\": {\n \"description\": \"A unique story NFT\",\n \"image\": \"https://example.com/nft/123.png\",\n \"name\": \"Art #123\"\n },\n \"owner\": \"email:creator@example.com:story-testnet\",\n \"licenseTerms\": [\n {\n \"terms\": {\n \"commercialRevShare\": 50,\n \"currency\": \"0x0000000000000000000000000000000000000000\",\n \"defaultMintingFee\": 100\n },\n \"type\": \"commercial-remix\"\n }\n ],\n \"reuploadLinkedFiles\": true,\n \"sendNotification\": true\n}"
response = http.request(request)
puts response.read_body{
"actionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"derivData": {
"licenseTermsIds": [
1
],
"maxMintingFee": 0,
"maxRevenueShare": 100,
"maxRts": 10000000,
"parentIpIds": [
"0x123"
]
},
"id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"ipAssetMetadata": {
"attributes": [
{
"key": "ISBN",
"value": "978-0-7475-3269-0"
},
{
"key": "Genre",
"value": "Fantasy"
}
],
"createdAt": "1997-06-26T00:00:00",
"creators": [
{
"contributionPercent": 80,
"crossmintUserLocator": "email:JKRowling@example.com:story",
"description": "Author",
"email": "JKRowling@example.com",
"name": "JK Rowling",
"socialMedia": [
{
"platform": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/J._K._Rowling"
}
]
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 15,
"description": "Illustrator",
"name": "Thomas Taylor"
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 5,
"description": "Publisher",
"email": "BloomsburyPublishing@example.com",
"name": "Bloomsbury Publishing",
"socialMedia": [
{
"platform": "Website",
"url": "https://www.bloomsbury.com/"
}
]
}
],
"image": "https://example.com/book-cover.jpg",
"imageHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"ipType": "literature",
"media": [
{
"mimeType": "application/epub+zip",
"name": "ePub",
"url": "link_to_epub"
},
{
"mimeType": "application/pdf",
"name": "Book Summary PDF",
"url": "link_to_book_summary_pdf"
}
],
"mediaHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"mediaType": "application/epub+zip",
"mediaUrl": "link_to_epub",
"title": "Harry Potter and the Philosopher's Stone"
},
"nftMetadata": {
"description": "A unique story NFT",
"image": "https://example.com/nft/123.png",
"name": "Art #123"
},
"onChain": {
"chain": "story-testnet",
"contractAddress": "0x123",
"status": "pending"
},
"licenseTerms": [
{
"terms": {
"commercialRevShare": 50,
"currency": "0x0000000000000000000000000000000000000000",
"defaultMintingFee": 100
},
"type": "commercial-remix"
}
]
}This API is still under development. Contact support for early access.
Headers
API key required for authentication
Path Parameters
Body
application/json
Data for the parent IP asset and license terms (for derivative IP assets only)
Show child attributes
Show child attributes
Example:
{
"licenseTermsIds": [1],
"parentIpIds": ["0x123"]
}
Metadata containing information about the IP asset itself
Show child attributes
Show child attributes
Example:
{
"attributes": [
{
"key": "ISBN",
"value": "978-0-7475-3269-0"
},
{ "key": "Genre", "value": "Fantasy" }
],
"createdAt": "1997-06-26T00:00:00",
"creators": [
{
"contributionPercent": 80,
"crossmintUserLocator": "email:JKRowling@example.com:story",
"description": "Author",
"email": "JKRowling@example.com",
"name": "JK Rowling",
"socialMedia": [
{
"platform": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/J._K._Rowling"
}
]
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 15,
"description": "Illustrator",
"name": "Thomas Taylor"
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 5,
"description": "Publisher",
"email": "BloomsburyPublishing@example.com",
"name": "Bloomsbury Publishing",
"socialMedia": [
{
"platform": "Website",
"url": "https://www.bloomsbury.com/"
}
]
}
],
"image": "https://example.com/book-cover.jpg",
"imageHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"ipType": "literature",
"media": [
{
"mimeType": "application/epub+zip",
"name": "ePub",
"url": "link_to_epub"
},
{
"mimeType": "application/pdf",
"name": "Book Summary PDF",
"url": "link_to_book_summary_pdf"
}
],
"mediaHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"mediaType": "application/epub+zip",
"mediaUrl": "link_to_epub",
"title": "Harry Potter and the Philosopher's Stone"
}
Metadata for the NFT representation of this IP asset
Show child attributes
Show child attributes
Example:
{
"description": "A unique story NFT",
"image": "https://example.com/nft/123.png",
"name": "Art #123"
}
The owner (main creator) of the IP asset: Allowed formats:
<chain>:<address> or
email:<email_address>:<chain> or
userId:<userId>:<chain> or
twitter:<twitter_handle>:<chain>
Example:
"email:creator@example.com:story-testnet"
licenseTerms
(Commercial Remix License Terms · object | Commercial Use License Terms · object | Non-commercial Social Remixing License Terms · object)[]
Optional licensing parameters for the IP asset
License parameters
- Commercial Remix License Terms
- Commercial Use License Terms
- Non-commercial Social Remixing License Terms
Show child attributes
Show child attributes
Example:
{
"terms": {
"commercialRevShare": 50,
"currency": "0x0000000000000000000000000000000000000000",
"defaultMintingFee": 100
},
"type": "commercial-remix"
}
The locale for the recipient's notification.
Available options:
Klingon, de-DE, en-US, es-ES, fr-FR, it-IT, ja-JP, ko-KR, pt-PT, ru-RU, th-TH, tr-TR, uk-UA, vi-VN, zh-CN, zh-TW Controls whether external files (like images) in the NFT metadata should be reuploaded to decentralized storage (IPFS) (true) or referenced with their original URLs (false). Default is True.
Example:
true
Whether to send a notification to the custodial wallet address, or the recipient if it was minted to an email address.
Response
201 - application/json
IP Asset created
The action id for the IPAsset creation
Example:
"d290f1ee-6c54-4b01-90e6-d701748f0851"
Data for the parent IP asset and license terms (for derivative IP assets only)
Show child attributes
Show child attributes
Example:
{
"licenseTermsIds": [1],
"maxMintingFee": 0,
"maxRevenueShare": 100,
"maxRts": 10000000,
"parentIpIds": ["0x123"]
}
The id of the IPAsset
Example:
"d290f1ee-6c54-4b01-90e6-d701748f0851"
Metadata containing information about the IP asset itself
Show child attributes
Show child attributes
Example:
{
"attributes": [
{
"key": "ISBN",
"value": "978-0-7475-3269-0"
},
{ "key": "Genre", "value": "Fantasy" }
],
"createdAt": "1997-06-26T00:00:00",
"creators": [
{
"contributionPercent": 80,
"crossmintUserLocator": "email:JKRowling@example.com:story",
"description": "Author",
"email": "JKRowling@example.com",
"name": "JK Rowling",
"socialMedia": [
{
"platform": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/J._K._Rowling"
}
]
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 15,
"description": "Illustrator",
"name": "Thomas Taylor"
},
{
"address": "0x1234567890123456789012345678901234567890",
"contributionPercent": 5,
"description": "Publisher",
"email": "BloomsburyPublishing@example.com",
"name": "Bloomsbury Publishing",
"socialMedia": [
{
"platform": "Website",
"url": "https://www.bloomsbury.com/"
}
]
}
],
"image": "https://example.com/book-cover.jpg",
"imageHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"ipType": "literature",
"media": [
{
"mimeType": "application/epub+zip",
"name": "ePub",
"url": "link_to_epub"
},
{
"mimeType": "application/pdf",
"name": "Book Summary PDF",
"url": "link_to_book_summary_pdf"
}
],
"mediaHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"mediaType": "application/epub+zip",
"mediaUrl": "link_to_epub",
"title": "Harry Potter and the Philosopher's Stone"
}
Metadata for the NFT representation of this IP asset
Show child attributes
Show child attributes
Example:
{
"description": "A unique story NFT",
"image": "https://example.com/nft/123.png",
"name": "Art #123"
}
Response schema for a pending IP asset creation request
- Option 1
- Option 2
Show child attributes
Show child attributes
Example:
{
"chain": "story-testnet",
"contractAddress": "0x123",
"status": "pending"
}
licenseTerms
(Commercial Remix License Terms · object | Commercial Use License Terms · object | Non-commercial Social Remixing License Terms · object)[]
Licensing parameters for the IP asset, NOTE: For detailed and updated license terms, refer to the 'Get IP Asset License' endpoint
License parameters
- Commercial Remix License Terms
- Commercial Use License Terms
- Non-commercial Social Remixing License Terms
Show child attributes
Show child attributes
Example:
{
"terms": {
"commercialRevShare": 50,
"currency": "0x0000000000000000000000000000000000000000",
"defaultMintingFee": 100
},
"type": "commercial-remix"
}
Was this page helpful?
⌘I