{"openapi":"3.1.0","info":{"title":"Stillmore Group API","version":"1.0","description":"Create releases, upload covers and masters, send them to distribution, follow them to the stores and read the money they make. Fields are only ever added within v1. Guides, error codes and webhooks: https://www.stillmoregroup.com/developers"},"servers":[{"url":"https://api.stillmoregroup.com/api/v1"}],"tags":[{"name":"Account"},{"name":"Reference"},{"name":"Labels"},{"name":"Artists"},{"name":"Releases"},{"name":"Tracks"},{"name":"Splits"},{"name":"Files"},{"name":"Distribution"},{"name":"Events"},{"name":"Webhooks"},{"name":"Money"},{"name":"Smart links"},{"name":"Cover licences"},{"name":"Sandbox"}],"paths":{"/me":{"get":{"operationId":"me.get","summary":"Who the key is","description":"The organization, the key's scopes and limits, and the release lead time. A cheap call to check a key works.","tags":["Account"],"security":[{"apiKey":[]},{"oauth":[]}],"parameters":[{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Who the key is","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["LABEL","ARTIST","MANAGEMENT"]}},"required":["id","name","kind"],"additionalProperties":false},"key":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mode":{"type":"string","enum":["live","test"]},"scopes":{"type":"array","items":{"type":"string","enum":["releases:read","releases:write","releases:submit","artists:read","artists:write","labels:read","labels:write","finance:read","payouts:write","webhooks:manage"]},"description":"Granted scopes, including the read scopes write scopes bring"},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"expiresAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"lastUsedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]}},"required":["id","name","mode","scopes","createdAt","expiresAt","lastUsedAt"],"additionalProperties":false},"keyOrganization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"description":"The organization the key belongs to; another than organization when the request acts for a sub-label"},"actingAs":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"description":"The member the key acts for"},"rateLimit":{"type":"object","properties":{"perMinute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Requests per minute for this key"},"organizationPerMinute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Requests per minute shared by every key of the organization"}},"required":["perMinute","organizationPerMinute"],"additionalProperties":false},"autoApproval":{"type":"boolean","description":"Submissions of this organization are approved without a person once their checks are clean"},"submissions":{"type":"object","properties":{"perDay":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Releases the API may submit per UTC day"}},"required":["perDay"],"additionalProperties":false},"releasePolicy":{"type":"object","properties":{"leadDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Days a release date must keep from submission"},"earliestReleaseDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The earliest release date a submission made today can carry"}},"required":["leadDays","earliestReleaseDate"],"additionalProperties":false}},"required":["organization","key","keyOrganization","actingAs","rateLimit","autoApproval","submissions","releasePolicy"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/reference":{"get":{"operationId":"reference.get","summary":"Genres, languages, countries and stores","description":"The values the catalogue accepts. Genres and languages are checked against these lists; store codes go in `stores.codes`.","tags":["Reference"],"security":[{"apiKey":[]},{"oauth":[]}],"parameters":[{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Genres, languages, countries and stores","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"}},"required":["code","name"],"additionalProperties":false}},"countries":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"region":{"type":"string"}},"required":["code","name","region"],"additionalProperties":false}},"stores":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"group":{"type":"string"}},"required":["code","name","group"],"additionalProperties":false}},"releaseTypes":{"type":"array","items":{"type":"string"}},"artistRoles":{"type":"array","items":{"type":"string"}},"creditRoles":{"type":"array","items":{"type":"string"}}},"required":["genres","languages","countries","stores","releaseTypes","artistRoles","creditRoles"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/labels":{"get":{"operationId":"labels.list","summary":"List labels","tags":["Labels"],"security":[{"apiKey":[]},{"oauth":["labels:read"]}],"x-scope":"labels:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"description":"nextCursor from the previous page","type":"string","maxLength":200},"description":"nextCursor from the previous page"},{"name":"updatedSince","in":"query","required":false,"schema":{"description":"Only records changed at or after this ISO 8601 time","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"Only records changed at or after this ISO 8601 time"},{"name":"externalId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"description":"Your own identifier for this record, unique within the organization"},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["ACTIVE","ARCHIVED"]}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"List labels","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"parentLabelId":{"type":["string","null"]},"contactEmail":{"type":["string","null"]},"releaseDefaults":{"type":"object","properties":{"cLineHolder":{"type":["string","null"]},"pLineHolder":{"type":["string","null"]},"primaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]}},"required":["cLineHolder","pLineHolder","primaryGenre","language"],"additionalProperties":false},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","name","status","parentLabelId","contactEmail","releaseDefaults","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"labels.create","summary":"Create a label or imprint","tags":["Labels"],"security":[{"apiKey":[]},{"oauth":["labels:write"]}],"x-scope":"labels:write","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"parentLabelId":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{24}$"},{"type":"null"}]},"contactEmail":{"anyOf":[{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"releaseDefaults":{"type":"object","properties":{"cLineHolder":{"anyOf":[{"type":"string","maxLength":180},{"type":"null"}]},"pLineHolder":{"anyOf":[{"type":"string","maxLength":180},{"type":"null"}]},"primaryGenre":{"anyOf":[{"description":"A genre name from GET /v1/reference","type":"string"},{"type":"null"}]},"language":{"anyOf":[{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},{"type":"null"}]}},"additionalProperties":false},"externalId":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Create a label or imprint","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"parentLabelId":{"type":["string","null"]},"contactEmail":{"type":["string","null"]},"releaseDefaults":{"type":"object","properties":{"cLineHolder":{"type":["string","null"]},"pLineHolder":{"type":["string","null"]},"primaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]}},"required":["cLineHolder","pLineHolder","primaryGenre","language"],"additionalProperties":false},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","name","status","parentLabelId","contactEmail","releaseDefaults","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["EXTERNAL_ID_IN_USE","PLAN_QUOTA_REACHED","DUPLICATE"]}},"/labels/{labelId}":{"get":{"operationId":"labels.get","summary":"Read a label","tags":["Labels"],"security":[{"apiKey":[]},{"oauth":["labels:read"]}],"x-scope":"labels:read","parameters":[{"name":"labelId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Read a label","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"parentLabelId":{"type":["string","null"]},"contactEmail":{"type":["string","null"]},"releaseDefaults":{"type":"object","properties":{"cLineHolder":{"type":["string","null"]},"pLineHolder":{"type":["string","null"]},"primaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]}},"required":["cLineHolder","pLineHolder","primaryGenre","language"],"additionalProperties":false},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","name","status","parentLabelId","contactEmail","releaseDefaults","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["LABEL_NOT_FOUND"]},"patch":{"operationId":"labels.update","summary":"Change a label","tags":["Labels"],"security":[{"apiKey":[]},{"oauth":["labels:write"]}],"x-scope":"labels:write","parameters":[{"name":"labelId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"parentLabelId":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{24}$"},{"type":"null"}]},"contactEmail":{"anyOf":[{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"releaseDefaults":{"type":"object","properties":{"cLineHolder":{"anyOf":[{"type":"string","maxLength":180},{"type":"null"}]},"pLineHolder":{"anyOf":[{"type":"string","maxLength":180},{"type":"null"}]},"primaryGenre":{"anyOf":[{"description":"A genre name from GET /v1/reference","type":"string"},{"type":"null"}]},"language":{"anyOf":[{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},{"type":"null"}]}},"additionalProperties":false},"externalId":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Change a label","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"parentLabelId":{"type":["string","null"]},"contactEmail":{"type":["string","null"]},"releaseDefaults":{"type":"object","properties":{"cLineHolder":{"type":["string","null"]},"pLineHolder":{"type":["string","null"]},"primaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]}},"required":["cLineHolder","pLineHolder","primaryGenre","language"],"additionalProperties":false},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","name","status","parentLabelId","contactEmail","releaseDefaults","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["LABEL_NOT_FOUND","REVISION_MISMATCH","EXTERNAL_ID_IN_USE"]}},"/artists":{"get":{"operationId":"artists.list","summary":"List artists","tags":["Artists"],"security":[{"apiKey":[]},{"oauth":["artists:read"]}],"x-scope":"artists:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"description":"nextCursor from the previous page","type":"string","maxLength":200},"description":"nextCursor from the previous page"},{"name":"updatedSince","in":"query","required":false,"schema":{"description":"Only records changed at or after this ISO 8601 time","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"Only records changed at or after this ISO 8601 time"},{"name":"externalId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"description":"Your own identifier for this record, unique within the organization"},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["ACTIVE","ARCHIVED"]}},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":160}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"List artists","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"roles":{"type":"array","items":{"type":"string","enum":["PERFORMER","SONGWRITER","COMPOSER"]}},"countryCode":{"type":["string","null"]},"profiles":{"type":"object","properties":{"spotify":{"type":["string","null"]},"appleMusic":{"type":["string","null"]},"youtube":{"type":["string","null"]}},"required":["spotify","appleMusic","youtube"],"additionalProperties":false},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","name","status","roles","countryCode","profiles","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"artists.create","summary":"Add an artist to the roster","tags":["Artists"],"security":[{"apiKey":[]},{"oauth":["artists:write"]}],"x-scope":"artists:write","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"countryCode":{"type":"string","minLength":2,"maxLength":2},"roles":{"description":"PERFORMER by default; SONGWRITER and COMPOSER entries are credits and don't count against the artist limit","minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["PERFORMER","SONGWRITER","COMPOSER"]}},"profiles":{"type":"object","properties":{"spotify":{"type":["string","null"]},"appleMusic":{"type":["string","null"]},"youtube":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]}},"additionalProperties":false},"externalId":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Add an artist to the roster","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"roles":{"type":"array","items":{"type":"string","enum":["PERFORMER","SONGWRITER","COMPOSER"]}},"countryCode":{"type":["string","null"]},"profiles":{"type":"object","properties":{"spotify":{"type":["string","null"]},"appleMusic":{"type":["string","null"]},"youtube":{"type":["string","null"]}},"required":["spotify","appleMusic","youtube"],"additionalProperties":false},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","name","status","roles","countryCode","profiles","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["EXTERNAL_ID_IN_USE","PLAN_QUOTA_REACHED","DUPLICATE_EXTERNAL_ARTIST_ID"]}},"/artists/{artistId}":{"get":{"operationId":"artists.get","summary":"Read an artist","tags":["Artists"],"security":[{"apiKey":[]},{"oauth":["artists:read"]}],"x-scope":"artists:read","parameters":[{"name":"artistId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Read an artist","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"roles":{"type":"array","items":{"type":"string","enum":["PERFORMER","SONGWRITER","COMPOSER"]}},"countryCode":{"type":["string","null"]},"profiles":{"type":"object","properties":{"spotify":{"type":["string","null"]},"appleMusic":{"type":["string","null"]},"youtube":{"type":["string","null"]}},"required":["spotify","appleMusic","youtube"],"additionalProperties":false},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","name","status","roles","countryCode","profiles","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["ARTIST_NOT_FOUND"]},"patch":{"operationId":"artists.update","summary":"Change an artist","tags":["Artists"],"security":[{"apiKey":[]},{"oauth":["artists:write"]}],"x-scope":"artists:write","parameters":[{"name":"artistId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"countryCode":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}]},"roles":{"description":"PERFORMER by default; SONGWRITER and COMPOSER entries are credits and don't count against the artist limit","minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["PERFORMER","SONGWRITER","COMPOSER"]}},"profiles":{"type":"object","properties":{"spotify":{"type":["string","null"]},"appleMusic":{"type":["string","null"]},"youtube":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]}},"additionalProperties":false},"externalId":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Change an artist","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"roles":{"type":"array","items":{"type":"string","enum":["PERFORMER","SONGWRITER","COMPOSER"]}},"countryCode":{"type":["string","null"]},"profiles":{"type":"object","properties":{"spotify":{"type":["string","null"]},"appleMusic":{"type":["string","null"]},"youtube":{"type":["string","null"]}},"required":["spotify","appleMusic","youtube"],"additionalProperties":false},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","name","status","roles","countryCode","profiles","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["ARTIST_NOT_FOUND","REVISION_MISMATCH","PLAN_QUOTA_REACHED"]}},"/releases":{"get":{"operationId":"releases.list","summary":"List releases","description":"Newest first. Filter by status, label, artist, UPC or your externalId; `updatedSince` returns what changed since your last sync.","tags":["Releases"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"description":"nextCursor from the previous page","type":"string","maxLength":200},"description":"nextCursor from the previous page"},{"name":"updatedSince","in":"query","required":false,"schema":{"description":"Only records changed at or after this ISO 8601 time","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"Only records changed at or after this ISO 8601 time"},{"name":"externalId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"description":"Your own identifier for this record, unique within the organization"},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"]}},{"name":"labelId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"name":"artistId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"name":"upc","in":"query","required":false,"schema":{"type":"string","maxLength":20}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"List releases","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"releases.create","summary":"Create a draft release","description":"Creates the draft and, when `tracks` is given, its tracks in order. A SINGLE always has exactly one track, created with the release.","tags":["Releases"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"labelId":{"description":"The organization's own label when left out","type":"string","pattern":"^[a-f0-9]{24}$"},"title":{"type":"string","minLength":1,"maxLength":180},"versionTitle":{"type":"string","maxLength":120},"type":{"description":"SINGLE by default","type":"string","enum":["SINGLE","EP","ALBUM"]},"primaryArtistIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"featuredArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"primaryGenre":{"description":"A genre name from GET /v1/reference","type":"string"},"secondaryGenre":{"description":"A genre name from GET /v1/reference","type":"string"},"language":{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},"explicit":{"type":"boolean"},"releaseDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"originalReleaseDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200},"holder":{"type":"string","maxLength":180}},"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200},"holder":{"type":"string","maxLength":180}},"additionalProperties":false}},"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"],"description":"WORLDWIDE, or CUSTOM to license only the listed countries"},"codes":{"maxItems":300,"type":"array","items":{"type":"string","minLength":2,"maxLength":2}}},"required":["mode"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"],"description":"ALL stores (new ones included), or CUSTOM to deliver only to the listed ones"},"codes":{"default":[],"maxItems":200,"type":"array","items":{"type":"string","enum":["spotify","apple_music","amazon_music","youtube_music","deezer","tidal","pandora","soundcloud","audiomack","napster","qobuz","iheartradio","youtube_content_id","tiktok","meta","snapchat","triller","beatport","traxsource","juno_download","7digital","tencent","netease","jiosaavn","gaana","hungama","joox","kkbox","line_music","awa","melon","genie","flo","bugs","vibe","anghami","boomplay","mdundo","yandex_music","vk_music","zvuk","fizy","claro_musica","peloton","trebel","shazam","gracenote","audible_magic"]}}},"required":["mode"],"additionalProperties":false},"upc":{"type":"string"},"externalId":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"},"tracks":{"description":"Tracks to create with the release, in order","maxItems":100,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":180},"versionTitle":{"type":"string","maxLength":120},"primaryArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"featuredArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"explicit":{"type":"boolean"},"isCover":{"description":"Someone else's song: it needs a cover licence before delivery","type":"boolean"},"language":{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},"isrc":{"type":"string"},"lyrics":{"type":"string","maxLength":20000},"credits":{"type":"object","properties":{"songwriters":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"composers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"producers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"publishers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"mixers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"masteringEngineers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"remixers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"additionalProperties":false},"externalId":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"}},"required":["title"],"additionalProperties":false}}},"required":["title","primaryArtistIds"],"additionalProperties":false}}}},"responses":{"201":{"description":"Create a draft release","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["EXTERNAL_ID_IN_USE","UPC_IN_USE","LABEL_NOT_FOUND","ARTIST_NOT_FOUND","LABEL_TRACK_LIMIT_REACHED"]}},"/releases/{releaseId}":{"get":{"operationId":"releases.get","summary":"Read a release with its tracks","tags":["Releases"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Read a release with its tracks","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND"]},"patch":{"operationId":"releases.update","summary":"Change a draft release","description":"Only drafts and releases sent back for changes can change. `null` clears a field that can be empty.","tags":["Releases"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"labelId":{"description":"The organization's own label when left out","type":"string","pattern":"^[a-f0-9]{24}$"},"title":{"type":"string","minLength":1,"maxLength":180},"versionTitle":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"type":{"description":"SINGLE by default","type":"string","enum":["SINGLE","EP","ALBUM"]},"primaryArtistIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"featuredArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"primaryGenre":{"description":"A genre name from GET /v1/reference","type":"string"},"secondaryGenre":{"description":"A genre name from GET /v1/reference","type":"string"},"language":{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},"explicit":{"type":"boolean"},"releaseDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200},"holder":{"type":"string","maxLength":180}},"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200},"holder":{"type":"string","maxLength":180}},"additionalProperties":false}},"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"],"description":"WORLDWIDE, or CUSTOM to license only the listed countries"},"codes":{"maxItems":300,"type":"array","items":{"type":"string","minLength":2,"maxLength":2}}},"required":["mode"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"],"description":"ALL stores (new ones included), or CUSTOM to deliver only to the listed ones"},"codes":{"default":[],"maxItems":200,"type":"array","items":{"type":"string","enum":["spotify","apple_music","amazon_music","youtube_music","deezer","tidal","pandora","soundcloud","audiomack","napster","qobuz","iheartradio","youtube_content_id","tiktok","meta","snapchat","triller","beatport","traxsource","juno_download","7digital","tencent","netease","jiosaavn","gaana","hungama","joox","kkbox","line_music","awa","melon","genie","flo","bugs","vibe","anghami","boomplay","mdundo","yandex_music","vk_music","zvuk","fizy","claro_musica","peloton","trebel","shazam","gracenote","audible_magic"]}}},"required":["mode"],"additionalProperties":false},"upc":{"type":["string","null"]},"externalId":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Change a draft release","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND","RELEASE_NOT_EDITABLE","REVISION_MISMATCH","UPC_IN_USE"]},"delete":{"operationId":"releases.delete","summary":"Archive a draft release","description":"Drafts and releases sent back for changes are archived (status ARCHIVED); nothing that went to review is deleted.","tags":["Releases"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Archive a draft release","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND","RELEASE_NOT_EDITABLE"]}},"/tracks":{"get":{"operationId":"tracks.list","summary":"Find tracks","description":"Across the organization, newest first: by ISRC, by your externalId, or every track changed since a time.","tags":["Tracks"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"description":"nextCursor from the previous page","type":"string","maxLength":200},"description":"nextCursor from the previous page"},{"name":"externalId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"description":"Your own identifier for this record, unique within the organization"},{"name":"isrc","in":"query","required":false,"schema":{"type":"string","maxLength":20}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Find tracks","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/releases/{releaseId}/tracks":{"get":{"operationId":"tracks.listForRelease","summary":"A release's tracklist","description":"Every track, in order (not paged).","tags":["Tracks"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"A release's tracklist","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND"]},"post":{"operationId":"tracks.create","summary":"Add a track","description":"At the end of the tracklist, or at `position` (the tracks from there move down). Primary artists default to the release's.","tags":["Tracks"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":180},"versionTitle":{"type":"string","maxLength":120},"primaryArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"featuredArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"explicit":{"type":"boolean"},"isCover":{"description":"Someone else's song: it needs a cover licence before delivery","type":"boolean"},"language":{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},"isrc":{"type":"string"},"lyrics":{"type":"string","maxLength":20000},"credits":{"type":"object","properties":{"songwriters":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"composers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"producers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"publishers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"mixers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"masteringEngineers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"remixers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"additionalProperties":false},"externalId":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"},"position":{"description":"Where the track goes; the end of the tracklist by default","type":"integer","minimum":1,"maximum":500}},"required":["title"],"additionalProperties":false}}}},"responses":{"201":{"description":"Add a track","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND","RELEASE_NOT_EDITABLE","RELEASE_SINGLE_TRACK_LIMIT","LABEL_TRACK_LIMIT_REACHED","EXTERNAL_ID_IN_USE"]}},"/releases/{releaseId}/tracks/order":{"put":{"operationId":"tracks.reorder","summary":"Reorder the tracklist","tags":["Tracks"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"trackIds":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"},"description":"Every track of the release, in the new order"}},"required":["trackIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"Reorder the tracklist","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND","INVALID_TRACK_REORDER"]}},"/tracks/{trackId}":{"get":{"operationId":"tracks.get","summary":"Read a track","tags":["Tracks"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Read a track","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["TRACK_NOT_FOUND"]},"patch":{"operationId":"tracks.update","summary":"Change a track","tags":["Tracks"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":180},"versionTitle":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"primaryArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"featuredArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"explicit":{"type":"boolean"},"isCover":{"description":"Someone else's song: it needs a cover licence before delivery","type":"boolean"},"language":{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},"isrc":{"type":["string","null"]},"lyrics":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}]},"credits":{"type":"object","properties":{"songwriters":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"composers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"producers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"publishers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"mixers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"masteringEngineers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"remixers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"additionalProperties":false},"externalId":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Change a track","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["TRACK_NOT_FOUND","RELEASE_NOT_EDITABLE","REVISION_MISMATCH"]},"delete":{"operationId":"tracks.delete","summary":"Remove a track","description":"The tracks after it move up.","tags":["Tracks"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Remove a track","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"deleted":{"type":"boolean","const":true}},"required":["id","deleted"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["TRACK_NOT_FOUND","RELEASE_NOT_EDITABLE"]}},"/releases/{releaseId}/split":{"get":{"operationId":"splits.getRelease","summary":"The release-wide royalty split","tags":["Splits"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"The release-wide royalty split","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"releaseId":{"type":"string"},"trackId":{"description":"Null for the release-wide split","type":["string","null"]},"parties":{"type":"array","items":{"type":"object","properties":{"artistId":{"type":["string","null"]},"name":{"type":"string"},"role":{"type":"string","enum":["ARTIST","FEATURED_ARTIST","PRODUCER","SONGWRITER","COMPOSER","LABEL","MANAGER","OTHER"]},"percent":{"type":"string"}},"required":["artistId","name","role","percent"],"additionalProperties":false}},"locked":{"type":"boolean","description":"A published statement used the split, so it can no longer change"},"updatedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]}},"required":["releaseId","trackId","parties","locked","updatedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND","TRACK_NOT_FOUND","ARTIST_NOT_FOUND","LABEL_NOT_FOUND"]},"put":{"operationId":"splits.putRelease","summary":"Set the release-wide royalty split","description":"Applies to every track without a split of its own. An empty `parties` removes it.","tags":["Splits"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"parties":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"artistId":{"anyOf":[{"type":"string","pattern":"^[a-f\\d]{24}$"},{"type":"null"}]},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","enum":["ARTIST","FEATURED_ARTIST","PRODUCER","SONGWRITER","COMPOSER","LABEL","MANAGER","OTHER"]},"percent":{"type":"string","pattern":"^\\d{1,3}(?:\\.\\d{1,2})?$"}},"required":["name","role","percent"]}}},"required":["parties"],"additionalProperties":false}}}},"responses":{"200":{"description":"Set the release-wide royalty split","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"releaseId":{"type":"string"},"trackId":{"description":"Null for the release-wide split","type":["string","null"]},"parties":{"type":"array","items":{"type":"object","properties":{"artistId":{"type":["string","null"]},"name":{"type":"string"},"role":{"type":"string","enum":["ARTIST","FEATURED_ARTIST","PRODUCER","SONGWRITER","COMPOSER","LABEL","MANAGER","OTHER"]},"percent":{"type":"string"}},"required":["artistId","name","role","percent"],"additionalProperties":false}},"locked":{"type":"boolean","description":"A published statement used the split, so it can no longer change"},"updatedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]}},"required":["releaseId","trackId","parties","locked","updatedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["SPLITS_LOCKED"]}},"/tracks/{trackId}/split":{"get":{"operationId":"splits.getTrack","summary":"A track's own royalty split","tags":["Splits"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"A track's own royalty split","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"releaseId":{"type":"string"},"trackId":{"description":"Null for the release-wide split","type":["string","null"]},"parties":{"type":"array","items":{"type":"object","properties":{"artistId":{"type":["string","null"]},"name":{"type":"string"},"role":{"type":"string","enum":["ARTIST","FEATURED_ARTIST","PRODUCER","SONGWRITER","COMPOSER","LABEL","MANAGER","OTHER"]},"percent":{"type":"string"}},"required":["artistId","name","role","percent"],"additionalProperties":false}},"locked":{"type":"boolean","description":"A published statement used the split, so it can no longer change"},"updatedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]}},"required":["releaseId","trackId","parties","locked","updatedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND","TRACK_NOT_FOUND","ARTIST_NOT_FOUND","LABEL_NOT_FOUND"]},"put":{"operationId":"splits.putTrack","summary":"Set a track's own royalty split","tags":["Splits"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"parties":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"artistId":{"anyOf":[{"type":"string","pattern":"^[a-f\\d]{24}$"},{"type":"null"}]},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","enum":["ARTIST","FEATURED_ARTIST","PRODUCER","SONGWRITER","COMPOSER","LABEL","MANAGER","OTHER"]},"percent":{"type":"string","pattern":"^\\d{1,3}(?:\\.\\d{1,2})?$"}},"required":["name","role","percent"]}}},"required":["parties"],"additionalProperties":false}}}},"responses":{"200":{"description":"Set a track's own royalty split","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"releaseId":{"type":"string"},"trackId":{"description":"Null for the release-wide split","type":["string","null"]},"parties":{"type":"array","items":{"type":"object","properties":{"artistId":{"type":["string","null"]},"name":{"type":"string"},"role":{"type":"string","enum":["ARTIST","FEATURED_ARTIST","PRODUCER","SONGWRITER","COMPOSER","LABEL","MANAGER","OTHER"]},"percent":{"type":"string"}},"required":["artistId","name","role","percent"],"additionalProperties":false}},"locked":{"type":"boolean","description":"A published statement used the split, so it can no longer change"},"updatedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]}},"required":["releaseId","trackId","parties","locked","updatedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["SPLITS_LOCKED"]}},"/releases/{releaseId}/artwork":{"post":{"operationId":"artwork.upload","summary":"Start a cover upload","description":"Returns a signed address valid for an hour. PUT the file there with the given headers, then call complete. Covers are square JPEG or PNG, exactly 3000 × 3000 pixels, in RGB, up to 25 MB.","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"The file's name, with its extension"},"contentType":{"type":"string","minLength":3,"maxLength":120,"description":"image/jpeg or image/png for covers; audio/wav or audio/flac for masters"},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Exact size in bytes; the PUT must send the same Content-Length"}},"required":["fileName","contentType","sizeBytes"],"additionalProperties":false}}}},"responses":{"201":{"description":"Start a cover upload","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"uploadId":{"type":"string"},"uploadUrl":{"type":"string","description":"PUT the file's bytes here"},"method":{"type":"string","const":"PUT"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Send these headers with the PUT, and Content-Length equal to sizeBytes"},"expiresAt":{"type":"string","description":"Upload and complete before this time"}},"required":["uploadId","uploadUrl","method","headers","expiresAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_EDITABLE","UPLOAD_RATE_LIMITED","INVALID_ARTWORK_FILE_TYPE","INVALID_AUDIO_FILE_TYPE"]},"get":{"operationId":"artwork.get","summary":"Download the cover","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Download the cover","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"url":{"type":"string","description":"A signed link to download the stored file"},"expiresAt":{"type":"string"}},"required":["url","expiresAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["ARTWORK_NOT_FOUND"]},"delete":{"operationId":"artwork.delete","summary":"Remove the cover","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Remove the cover","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_EDITABLE"]}},"/releases/{releaseId}/artwork/complete":{"post":{"operationId":"artwork.complete","summary":"Finish a cover upload","description":"Checks the stored file and puts it on the release, replacing any cover it had. Calling it again for the same upload changes nothing.","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uploadId":{"type":"string","pattern":"^[a-f0-9]{24}$"},"durationSeconds":{"type":"number","minimum":0,"maximum":21600}},"required":["uploadId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Finish a cover upload","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["UPLOAD_NOT_RECEIVED","UPLOAD_SESSION_EXPIRED","UPLOAD_SESSION_FORBIDDEN","ARTWORK_DIMENSIONS_INVALID","ARTWORK_CMYK"]}},"/releases/{releaseId}/artwork/import":{"post":{"operationId":"artwork.import","summary":"Fetch a cover from a link","description":"Stillmore Group downloads the file in the background and checks it like an upload. Follow the import with GET /v1/imports/{importId}. The link must answer with Content-Length.","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2000,"format":"uri","description":"A link the file can be downloaded from without signing in, such as a signed storage URL"},"fileName":{"description":"Overrides the name taken from the link","type":"string","minLength":1,"maxLength":255}},"required":["url"],"additionalProperties":false}}}},"responses":{"202":{"description":"Fetch a cover from a link","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["ARTWORK","AUDIO"]},"status":{"type":"string","enum":["PENDING","RUNNING","SUCCEEDED","FAILED"]},"releaseId":{"type":"string"},"trackId":{"type":["string","null"]},"source":{"type":"string"},"sizeBytes":{"type":["number","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","kind","status","releaseId","trackId","source","sizeBytes","error","createdAt","finishedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["IMPORT_URL_NOT_ALLOWED","RELEASE_NOT_EDITABLE"]}},"/tracks/{trackId}/audio":{"post":{"operationId":"audio.upload","summary":"Start a master upload","description":"Returns a signed address valid for an hour. Masters are WAV or FLAC, up to 500 MB.","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"The file's name, with its extension"},"contentType":{"type":"string","minLength":3,"maxLength":120,"description":"image/jpeg or image/png for covers; audio/wav or audio/flac for masters"},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Exact size in bytes; the PUT must send the same Content-Length"}},"required":["fileName","contentType","sizeBytes"],"additionalProperties":false}}}},"responses":{"201":{"description":"Start a master upload","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"uploadId":{"type":"string"},"uploadUrl":{"type":"string","description":"PUT the file's bytes here"},"method":{"type":"string","const":"PUT"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Send these headers with the PUT, and Content-Length equal to sizeBytes"},"expiresAt":{"type":"string","description":"Upload and complete before this time"}},"required":["uploadId","uploadUrl","method","headers","expiresAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_EDITABLE","UPLOAD_RATE_LIMITED","INVALID_ARTWORK_FILE_TYPE","INVALID_AUDIO_FILE_TYPE"]},"get":{"operationId":"audio.get","summary":"Download the master","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Download the master","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"url":{"type":"string","description":"A signed link to download the stored file"},"expiresAt":{"type":"string"}},"required":["url","expiresAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["AUDIO_NOT_FOUND"]},"delete":{"operationId":"audio.delete","summary":"Remove the master","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Remove the master","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_EDITABLE"]}},"/tracks/{trackId}/audio/complete":{"post":{"operationId":"audio.complete","summary":"Finish a master upload","description":"Checks the stored file (it must really be WAV or FLAC), reads its duration, sample rate and bit depth, and starts the copyright scan.","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uploadId":{"type":"string","pattern":"^[a-f0-9]{24}$"},"durationSeconds":{"type":"number","minimum":0,"maximum":21600}},"required":["uploadId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Finish a master upload","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["UPLOAD_NOT_RECEIVED","UPLOAD_SESSION_EXPIRED","UPLOAD_SESSION_FORBIDDEN","ARTWORK_DIMENSIONS_INVALID","ARTWORK_CMYK"]}},"/tracks/{trackId}/audio/import":{"post":{"operationId":"audio.import","summary":"Fetch a master from a link","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"trackId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2000,"format":"uri","description":"A link the file can be downloaded from without signing in, such as a signed storage URL"},"fileName":{"description":"Overrides the name taken from the link","type":"string","minLength":1,"maxLength":255}},"required":["url"],"additionalProperties":false}}}},"responses":{"202":{"description":"Fetch a master from a link","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["ARTWORK","AUDIO"]},"status":{"type":"string","enum":["PENDING","RUNNING","SUCCEEDED","FAILED"]},"releaseId":{"type":"string"},"trackId":{"type":["string","null"]},"source":{"type":"string"},"sizeBytes":{"type":["number","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","kind","status","releaseId","trackId","source","sizeBytes","error","createdAt","finishedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["IMPORT_URL_NOT_ALLOWED","RELEASE_NOT_EDITABLE"]}},"/imports/{importId}":{"get":{"operationId":"imports.get","summary":"Follow a file import","tags":["Files"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"importId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Follow a file import","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["ARTWORK","AUDIO"]},"status":{"type":"string","enum":["PENDING","RUNNING","SUCCEEDED","FAILED"]},"releaseId":{"type":"string"},"trackId":{"type":["string","null"]},"source":{"type":"string"},"sizeBytes":{"type":["number","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","kind","status","releaseId","trackId","source","sizeBytes","error","createdAt","finishedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["IMPORT_NOT_FOUND"]}},"/releases/batch":{"post":{"operationId":"releases.createBatch","summary":"Create many draft releases","description":"Each release is created on its own, as POST /v1/releases would; the answer lists every result in the order sent. One failing doesn't stop the others.","tags":["Releases"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"releases":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"labelId":{"description":"The organization's own label when left out","type":"string","pattern":"^[a-f0-9]{24}$"},"title":{"type":"string","minLength":1,"maxLength":180},"versionTitle":{"type":"string","maxLength":120},"type":{"description":"SINGLE by default","type":"string","enum":["SINGLE","EP","ALBUM"]},"primaryArtistIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"featuredArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"primaryGenre":{"description":"A genre name from GET /v1/reference","type":"string"},"secondaryGenre":{"description":"A genre name from GET /v1/reference","type":"string"},"language":{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},"explicit":{"type":"boolean"},"releaseDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"originalReleaseDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200},"holder":{"type":"string","maxLength":180}},"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200},"holder":{"type":"string","maxLength":180}},"additionalProperties":false}},"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"],"description":"WORLDWIDE, or CUSTOM to license only the listed countries"},"codes":{"maxItems":300,"type":"array","items":{"type":"string","minLength":2,"maxLength":2}}},"required":["mode"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"],"description":"ALL stores (new ones included), or CUSTOM to deliver only to the listed ones"},"codes":{"default":[],"maxItems":200,"type":"array","items":{"type":"string","enum":["spotify","apple_music","amazon_music","youtube_music","deezer","tidal","pandora","soundcloud","audiomack","napster","qobuz","iheartradio","youtube_content_id","tiktok","meta","snapchat","triller","beatport","traxsource","juno_download","7digital","tencent","netease","jiosaavn","gaana","hungama","joox","kkbox","line_music","awa","melon","genie","flo","bugs","vibe","anghami","boomplay","mdundo","yandex_music","vk_music","zvuk","fizy","claro_musica","peloton","trebel","shazam","gracenote","audible_magic"]}}},"required":["mode"],"additionalProperties":false},"upc":{"type":"string"},"externalId":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"},"tracks":{"description":"Tracks to create with the release, in order","maxItems":100,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":180},"versionTitle":{"type":"string","maxLength":120},"primaryArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"featuredArtistIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"explicit":{"type":"boolean"},"isCover":{"description":"Someone else's song: it needs a cover licence before delivery","type":"boolean"},"language":{"description":"An ISO 639-1 code (\"en\") or a language name from GET /v1/reference","type":"string"},"isrc":{"type":"string"},"lyrics":{"type":"string","maxLength":20000},"credits":{"type":"object","properties":{"songwriters":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"composers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"producers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"publishers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"mixers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"masteringEngineers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"remixers":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"additionalProperties":false},"externalId":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\x21-\\x7E]+$","description":"Your own identifier for this record, unique within the organization"},"metadata":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"additionalProperties":{"type":"string","maxLength":500},"description":"Key-value pairs you attach for your own use"}},"required":["title"],"additionalProperties":false}}},"required":["title","primaryArtistIds"],"additionalProperties":false},"description":"Up to 25 drafts, each created on its own"}},"required":["releases"],"additionalProperties":false}}}},"responses":{"200":{"description":"Create many draft releases","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ok":{"type":"boolean"},"release":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false},{"type":"null"}]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]}},"required":["index","ok","release","error"],"additionalProperties":false}}},"required":["results"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/releases/{releaseId}/checks":{"get":{"operationId":"releases.checks","summary":"Check a release before sending it","description":"Everything submission requires, plus the store rules reviewers check by eye: audio quality, titles (no \"feat.\", promotional words, emoji or shouting capitals), artist names, codes already used elsewhere, cover licences. ERROR items block a submission (submission rules) or automatic approval (store rules); WARNING items are for a person to judge.","tags":["Distribution"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Check a release before sending it","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"submittable":{"type":"boolean","description":"Nothing stops a submission"},"clean":{"type":"boolean","description":"No ERROR at all: nothing would hold back an automatic approval"},"checks":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["ERROR","WARNING"]},"path":{"type":"string","description":"The field, e.g. tracks[1].audio"},"message":{"type":"string"}},"required":["code","severity","path","message"],"additionalProperties":false}}},"required":["submittable","clean","checks"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND"]}},"/releases/{releaseId}/submit":{"post":{"operationId":"releases.submit","summary":"Send a release to distribution","description":"The release joins Stillmore Group's review queue exactly as one submitted in the workspace does (paid plans are reviewed first). On an account with automatic approval it is approved without a person once its checks are clean, and goes straight to delivery. Follow it with the release.* webhooks or GET /v1/events.","tags":["Distribution"],"security":[{"apiKey":[]},{"oauth":["releases:submit"]}],"x-scope":"releases:submit","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"note":{"description":"A note for the reviewers","type":"string","maxLength":2000}},"additionalProperties":false}}}},"responses":{"200":{"description":"Send a release to distribution","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_SUBMISSION_INVALID","INVALID_RELEASE_STATUS","PLAN_QUOTA_REACHED","SUBMISSION_LIMIT_REACHED","ORGANIZATION_SUSPENDED"]}},"/releases/submit":{"post":{"operationId":"releases.submitBatch","summary":"Send many releases to distribution","description":"Up to 50 releases, each submitted on its own; the answer lists every result. The daily submission limit counts each one.","tags":["Distribution"],"security":[{"apiKey":[]},{"oauth":["releases:submit"]}],"x-scope":"releases:submit","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"releaseIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{24}$"},"description":"Up to 50 releases, each submitted on its own"},"note":{"type":"string","maxLength":2000}},"required":["releaseIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"Send many releases to distribution","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"releaseId":{"type":"string"},"ok":{"type":"boolean"},"status":{"description":"The release's status after the attempt","type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]}},"required":["releaseId","ok","status","error"],"additionalProperties":false}}},"required":["results"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["SUBMISSION_LIMIT_REACHED"]}},"/releases/{releaseId}/takedown":{"post":{"operationId":"releases.takedown","summary":"Ask for a live release to come down","description":"Stillmore Group's team takes it down from the stores; the release.taken_down webhook tells you when it's done.","tags":["Distribution"],"security":[{"apiKey":[]},{"oauth":["releases:submit"]}],"x-scope":"releases:submit","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":10,"maxLength":2000,"description":"Why the release should come down, for Stillmore Group's team"}},"required":["reason"],"additionalProperties":false}}}},"responses":{"201":{"description":"Ask for a live release to come down","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"status":{"type":"string"},"reason":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","releaseId","status","reason","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["TAKEDOWN_NOT_ALLOWED","TAKEDOWN_ALREADY_REQUESTED"]}},"/releases/{releaseId}/documents":{"post":{"operationId":"documents.upload","summary":"Start a document upload","description":"When review asks for documents (proof of rights, licences, agreements: review.documentsRequested), upload them here: PDF, Word, JPEG or PNG up to 20 MB.","tags":["Distribution"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"The file's name, with its extension"},"contentType":{"type":"string","minLength":3,"maxLength":120,"description":"image/jpeg or image/png for covers; audio/wav or audio/flac for masters"},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Exact size in bytes; the PUT must send the same Content-Length"}},"required":["fileName","contentType","sizeBytes"],"additionalProperties":false}}}},"responses":{"201":{"description":"Start a document upload","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"uploadId":{"type":"string"},"uploadUrl":{"type":"string","description":"PUT the file's bytes here"},"method":{"type":"string","const":"PUT"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Send these headers with the PUT, and Content-Length equal to sizeBytes"},"expiresAt":{"type":"string","description":"Upload and complete before this time"}},"required":["uploadId","uploadUrl","method","headers","expiresAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/releases/{releaseId}/documents/complete":{"post":{"operationId":"documents.complete","summary":"Finish a document upload","tags":["Distribution"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uploadId":{"type":"string","pattern":"^[a-f0-9]{24}$"},"durationSeconds":{"type":"number","minimum":0,"maximum":21600}},"required":["uploadId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Finish a document upload","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["UPLOAD_NOT_RECEIVED"]}},"/events":{"get":{"operationId":"events.list","summary":"Read back events","description":"Every event your webhooks can receive, newest first, kept for 30 days whether or not an endpoint was listening. Use it to catch up after downtime or instead of webhooks. A key sees the events its scopes cover: release and takedown events need releases:read, payout and statement events finance:read, claim events either.","tags":["Events"],"security":[{"apiKey":[]},{"oauth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"type","in":"query","required":false,"schema":{"description":"One event name, or a family such as release.*","type":"string","maxLength":60},"description":"One event name, or a family such as release.*"},{"name":"since","in":"query","required":false,"schema":{"description":"Only events at or after this time","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"Only events at or after this time"},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Read back events","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","description":"The webhook event name, e.g. release.live"},"occurredAt":{"type":"string"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"The same data the webhook carries; release events include the release as GET /v1/releases/{id} shows it"}},"required":["id","type","occurredAt","data"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/webhooks":{"get":{"operationId":"webhooks.list","summary":"List webhook endpoints","tags":["Webhooks"],"security":[{"apiKey":[]},{"oauth":["webhooks:manage"]}],"x-scope":"webhooks:manage","parameters":[{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"List webhook endpoints","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"description":{"type":["string","null"]},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"lastDeliveryAt":{"type":["string","null"]},"lastDeliveryStatus":{"anyOf":[{"type":"string","enum":["DELIVERED","FAILED"]},{"type":"null"}]},"previousSecretExpiresAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","url","description","events","active","lastDeliveryAt","lastDeliveryStatus","previousSecretExpiresAt","createdAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"webhooks.create","summary":"Register an endpoint","description":"Up to ten https endpoints. The answer shows the signing secret once.","tags":["Webhooks"],"security":[{"apiKey":[]},{"oauth":["webhooks:manage"]}],"x-scope":"webhooks:manage","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2000,"format":"uri"},"description":{"type":"string","maxLength":160},"events":{"default":["*"],"anyOf":[{"minItems":1,"maxItems":1,"type":"array","items":{"type":"string","const":"*"}},{"minItems":1,"maxItems":19,"type":"array","items":{"type":"string","enum":["release.submitted","release.changes_requested","release.rejected","release.approved","release.sent","release.codes_assigned","release.store_links_updated","release.live","release.provider_rejected","release.taken_down","takedown.requested","payout.requested","payout.approved","payout.rejected","payout.paid","payout.failed","statement.published","claim.created","claim.status_changed"]}}]}},"required":["url"]}}}},"responses":{"201":{"description":"Register an endpoint","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"webhook":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"description":{"type":["string","null"]},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"lastDeliveryAt":{"type":["string","null"]},"lastDeliveryStatus":{"anyOf":[{"type":"string","enum":["DELIVERED","FAILED"]},{"type":"null"}]},"previousSecretExpiresAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","url","description","events","active","lastDeliveryAt","lastDeliveryStatus","previousSecretExpiresAt","createdAt"],"additionalProperties":false},"secret":{"type":"string","description":"Shown once"}},"required":["webhook","secret"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["WEBHOOK_LIMIT"]}},"/webhooks/{webhookId}":{"patch":{"operationId":"webhooks.update","summary":"Change or pause an endpoint","tags":["Webhooks"],"security":[{"apiKey":[]},{"oauth":["webhooks:manage"]}],"x-scope":"webhooks:manage","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2000,"format":"uri"},"description":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}]},"events":{"anyOf":[{"minItems":1,"maxItems":1,"type":"array","items":{"type":"string","const":"*"}},{"minItems":1,"maxItems":19,"type":"array","items":{"type":"string","enum":["release.submitted","release.changes_requested","release.rejected","release.approved","release.sent","release.codes_assigned","release.store_links_updated","release.live","release.provider_rejected","release.taken_down","takedown.requested","payout.requested","payout.approved","payout.rejected","payout.paid","payout.failed","statement.published","claim.created","claim.status_changed"]}}]},"active":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Change or pause an endpoint","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"description":{"type":["string","null"]},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"lastDeliveryAt":{"type":["string","null"]},"lastDeliveryStatus":{"anyOf":[{"type":"string","enum":["DELIVERED","FAILED"]},{"type":"null"}]},"previousSecretExpiresAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","url","description","events","active","lastDeliveryAt","lastDeliveryStatus","previousSecretExpiresAt","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["WEBHOOK_NOT_FOUND"]},"delete":{"operationId":"webhooks.delete","summary":"Remove an endpoint","tags":["Webhooks"],"security":[{"apiKey":[]},{"oauth":["webhooks:manage"]}],"x-scope":"webhooks:manage","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Remove an endpoint","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["WEBHOOK_NOT_FOUND"]}},"/webhooks/{webhookId}/test":{"post":{"operationId":"webhooks.test","summary":"Send a test ping","tags":["Webhooks"],"security":[{"apiKey":[]},{"oauth":["webhooks:manage"]}],"x-scope":"webhooks:manage","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Send a test ping","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"event":{"type":"string"},"status":{"type":"string","enum":["PENDING","DELIVERED","FAILED"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"responseStatus":{"type":["number","null"]},"error":{"type":["string","null"]},"deliveredAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","event","status","attempts","responseStatus","error","deliveredAt","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["WEBHOOK_NOT_FOUND"]}},"/webhooks/{webhookId}/deliveries":{"get":{"operationId":"webhooks.deliveries","summary":"The endpoint's last 25 deliveries","tags":["Webhooks"],"security":[{"apiKey":[]},{"oauth":["webhooks:manage"]}],"x-scope":"webhooks:manage","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"The endpoint's last 25 deliveries","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"event":{"type":"string"},"status":{"type":"string","enum":["PENDING","DELIVERED","FAILED"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"responseStatus":{"type":["number","null"]},"error":{"type":["string","null"]},"deliveredAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","event","status","attempts","responseStatus","error","deliveredAt","createdAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["WEBHOOK_NOT_FOUND"]}},"/webhooks/{webhookId}/rotate-secret":{"post":{"operationId":"webhooks.rotateSecret","summary":"Rotate the signing secret","description":"A new secret, shown once. The old one keeps signing alongside it (two v1= signatures) for graceHours, 24 by default.","tags":["Webhooks"],"security":[{"apiKey":[]},{"oauth":["webhooks:manage"]}],"x-scope":"webhooks:manage","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"graceHours":{"default":24,"type":"integer","minimum":0,"maximum":72}}}}}},"responses":{"200":{"description":"Rotate the signing secret","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"webhook":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"description":{"type":["string","null"]},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"lastDeliveryAt":{"type":["string","null"]},"lastDeliveryStatus":{"anyOf":[{"type":"string","enum":["DELIVERED","FAILED"]},{"type":"null"}]},"previousSecretExpiresAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","url","description","events","active","lastDeliveryAt","lastDeliveryStatus","previousSecretExpiresAt","createdAt"],"additionalProperties":false},"secret":{"type":"string","description":"Shown once"}},"required":["webhook","secret"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["WEBHOOK_NOT_FOUND"]}},"/balance":{"get":{"operationId":"balance.get","summary":"The balance, per currency","description":"What the organization has earned, the advance still to recoup, payouts on their way, and what can be paid out now.","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"The balance, per currency","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"available":{"type":"string","description":"What can be paid out now: earnings minus the advance still to recoup and the payouts on their way"},"earnings":{"type":"string","description":"Royalties and adjustments credited, minus fees, payouts and recoupments"},"advanceOutstanding":{"type":"string","description":"Advance granted and not recouped yet"},"pendingPayouts":{"type":"string","description":"Payouts requested and not paid or refused yet"},"minimumPayout":{"anyOf":[{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},{"type":"null"}]}},"required":["currency","available","earnings","advanceOutstanding","pendingPayouts","minimumPayout"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/transactions":{"get":{"operationId":"transactions.list","summary":"Ledger entries","description":"Every credit and debit of the balance, newest first: royalties, fees, payouts, adjustments, recoupments, transfers.","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"currency","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["ROYALTY_CREDIT","ADJUSTMENT_CREDIT","ADJUSTMENT_DEBIT","PAYOUT_DEBIT","FEE_DEBIT","ADVANCE_RECOUPMENT","TRANSFER_OUT","TRANSFER_IN","REFERRAL_CREDIT","PROMOTION_DEBIT","PROMOTION_REFUND","COVER_LICENSE_DEBIT","COVER_LICENSE_REFUND"]}},{"name":"since","in":"query","required":false,"schema":{"description":"Only entries at or after this time","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"description":"Only entries at or after this time"},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Ledger entries","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["ROYALTY_CREDIT","ADJUSTMENT_CREDIT","ADJUSTMENT_DEBIT","PAYOUT_DEBIT","FEE_DEBIT","ADVANCE_RECOUPMENT","TRANSFER_OUT","TRANSFER_IN","REFERRAL_CREDIT","PROMOTION_DEBIT","PROMOTION_REFUND","COVER_LICENSE_DEBIT","COVER_LICENSE_REFUND"]},"amount":{"type":"string","description":"Signed: credits positive, debits negative"},"currency":{"type":"string"},"description":{"type":"string"},"occurredAt":{"type":"string"},"statementId":{"description":"The statement a royalty credit came with","type":["string","null"]},"source":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":false,"description":"What made the entry: a statement, a payout, an adjustment…"}},"required":["id","type","amount","currency","description","occurredAt","statementId","source"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/earnings":{"get":{"operationId":"earnings.get","summary":"Earnings by month, release, track, store or territory","description":"What the stores reported, summed by groupBy over the royalty lines matched to the catalogue, biggest first (months in order). Filter by reporting months, currency, release, track, store or territory. Gross, before commission: statements carry the net.","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"groupBy","in":"query","required":false,"schema":{"default":"month","type":"string","enum":["month","release","track","store","territory"]}},{"name":"from","in":"query","required":false,"schema":{"description":"First reporting month, YYYY-MM","type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"},"description":"First reporting month, YYYY-MM"},{"name":"to","in":"query","required":false,"schema":{"description":"Last reporting month, YYYY-MM","type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"},"description":"Last reporting month, YYYY-MM"},{"name":"currency","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"releaseId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"name":"trackId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"name":"store","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"territory","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Earnings by month, release, track, store or territory","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"groupBy":{"type":"string","enum":["month","release","track","store","territory"]},"rows":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"The month (YYYY-MM), release id, track id, store, or territory code"},"label":{"type":"string","description":"The month, the release or track title, the store, or the country"},"currency":{"type":"string"},"units":{"type":"number","description":"Streams and downloads as the stores reported them"},"gross":{"type":"string","description":"As the stores reported it, before Stillmore Group's commission; statements carry the net"}},"required":["key","label","currency","units","gross"],"additionalProperties":false}},"totals":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"units":{"type":"number"},"gross":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""}},"required":["currency","units","gross"],"additionalProperties":false}}},"required":["groupBy","rows","totals"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/statements":{"get":{"operationId":"statements.list","summary":"Published royalty statements","description":"Statements Stillmore Group published to the organization, newest first. Drafts never show; one withdrawn after publishing stays listed with status VOID.","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"currency","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{3}$"}},{"name":"period","in":"query","required":false,"schema":{"description":"Only statements covering this month","type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"},"description":"Only statements covering this month"},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Published royalty statements","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["PUBLISHED","VOID"],"description":"VOID: Stillmore Group withdrew it after publishing and a corrected statement follows; its lines and CSV answer 410"},"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"currency":{"type":"string"},"gross":{"type":"string","description":"What the stores reported for the period"},"fees":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"net":{"type":"string","description":"What was credited to the balance"},"revenueSharePercent":{"description":"The organization's share applied, when an agreement set one","type":["string","null"]},"version":{"type":"number"},"publishedAt":{"type":["string","null"]}},"required":["id","status","periodStart","periodEnd","currency","gross","fees","net","revenueSharePercent","version","publishedAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/statements/{statementId}":{"get":{"operationId":"statements.get","summary":"One statement","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"statementId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"One statement","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["PUBLISHED","VOID"],"description":"VOID: Stillmore Group withdrew it after publishing and a corrected statement follows; its lines and CSV answer 410"},"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"currency":{"type":"string"},"gross":{"type":"string","description":"What the stores reported for the period"},"fees":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"net":{"type":"string","description":"What was credited to the balance"},"revenueSharePercent":{"description":"The organization's share applied, when an agreement set one","type":["string","null"]},"version":{"type":"number"},"publishedAt":{"type":["string","null"]}},"required":["id","status","periodStart","periodEnd","currency","gross","fees","net","revenueSharePercent","version","publishedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["STATEMENT_NOT_FOUND"]}},"/statements/{statementId}/lines":{"get":{"operationId":"statements.lines","summary":"The royalty lines behind a statement","description":"Each store line of the statement's period and currency, up to 500 a page.","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"statementId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"releaseId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"name":"store","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"territory","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"The royalty lines behind a statement","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":["string","null"]},"trackId":{"type":["string","null"]},"isrc":{"type":["string","null"]},"upc":{"type":["string","null"]},"store":{"type":["string","null"]},"territory":{"type":["string","null"]},"units":{"type":["number","null"]},"gross":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"currency":{"type":"string"},"periodStart":{"type":["string","null"]},"periodEnd":{"type":["string","null"]},"usageDate":{"type":["string","null"]}},"required":["id","releaseId","trackId","isrc","upc","store","territory","units","gross","currency","periodStart","periodEnd","usageDate"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["STATEMENT_NOT_FOUND","STATEMENT_VOID"]}},"/statements/{statementId}/export":{"get":{"operationId":"statements.export","summary":"The statement's lines as CSV","description":"Every line in one text/csv file (UTF-8, comma separated, a header row), the same columns as the lines endpoint.","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"statementId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"The statement's lines as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["STATEMENT_NOT_FOUND","STATEMENT_VOID"]}},"/payout-methods":{"get":{"operationId":"payoutMethods.list","summary":"Saved payout methods","description":"The bank, PayPal and Payoneer accounts saved in the workspace, masked. Payouts through the API can only go to these.","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Saved payout methods","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","BANK_ACCOUNT","PAYPAL","PAYONEER"]},"label":{"type":"string"},"summary":{"type":"string","description":"The account, masked: GB•• •••• 4821, •••• 0042, PayPal"},"id":{"type":"string"},"isDefault":{"type":"boolean"}},"required":["type","label","summary","id","isDefault"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/payouts":{"get":{"operationId":"payouts.list","summary":"Payout requests","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED","PROCESSING","PAID","FAILED","CANCELLED"]}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Payout requests","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"currency":{"type":"string"},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED","PROCESSING","PAID","FAILED","CANCELLED"]},"destination":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","BANK_ACCOUNT","PAYPAL","PAYONEER"]},"label":{"type":"string"},"summary":{"type":"string","description":"The account, masked: GB•• •••• 4821, •••• 0042, PayPal"}},"required":["type","label","summary"],"additionalProperties":false},"note":{"type":["string","null"]},"reviewNote":{"description":"Stillmore Group's note when approving or refusing","type":["string","null"]},"paymentReference":{"type":["string","null"]},"paidAt":{"type":["string","null"]},"cancelledAt":{"type":["string","null"]},"requestedVia":{"type":"string","enum":["APP","API"]},"createdAt":{"type":"string"}},"required":["id","amount","currency","status","destination","note","reviewNote","paymentReference","paidAt","cancelledAt","requestedVia","createdAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"payouts.create","summary":"Request a payout","description":"Asks Stillmore Group to pay out part of the available balance to a saved payout method. An owner or admin must first allow payout requests through the API in Workspace › API › Settings (with an authenticator code), and each request is told to them. Stillmore Group reviews it as any other: it stays PENDING until approved, then PAID. Send an Idempotency-Key so a retry never asks twice.","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["payouts:write"]}],"x-scope":"payouts:write","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"currency":{"default":"USD","type":"string"},"payoutMethodId":{"type":"string","pattern":"^[a-f0-9]{24}$","description":"One of GET /v1/payout-methods; methods are added in the workspace"},"note":{"type":"string","maxLength":500}},"required":["amount","payoutMethodId"],"additionalProperties":false}}}},"responses":{"201":{"description":"Request a payout","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"currency":{"type":"string"},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED","PROCESSING","PAID","FAILED","CANCELLED"]},"destination":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","BANK_ACCOUNT","PAYPAL","PAYONEER"]},"label":{"type":"string"},"summary":{"type":"string","description":"The account, masked: GB•• •••• 4821, •••• 0042, PayPal"}},"required":["type","label","summary"],"additionalProperties":false},"note":{"type":["string","null"]},"reviewNote":{"description":"Stillmore Group's note when approving or refusing","type":["string","null"]},"paymentReference":{"type":["string","null"]},"paidAt":{"type":["string","null"]},"cancelledAt":{"type":["string","null"]},"requestedVia":{"type":"string","enum":["APP","API"]},"createdAt":{"type":"string"}},"required":["id","amount","currency","status","destination","note","reviewNote","paymentReference","paidAt","cancelledAt","requestedVia","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["API_PAYOUTS_OFF","PAYOUT_METHOD_NOT_FOUND","INSUFFICIENT_BALANCE","BELOW_MINIMUM_PAYOUT"]}},"/payouts/{payoutId}":{"get":{"operationId":"payouts.get","summary":"One payout request","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"payoutId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"One payout request","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"currency":{"type":"string"},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED","PROCESSING","PAID","FAILED","CANCELLED"]},"destination":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","BANK_ACCOUNT","PAYPAL","PAYONEER"]},"label":{"type":"string"},"summary":{"type":"string","description":"The account, masked: GB•• •••• 4821, •••• 0042, PayPal"}},"required":["type","label","summary"],"additionalProperties":false},"note":{"type":["string","null"]},"reviewNote":{"description":"Stillmore Group's note when approving or refusing","type":["string","null"]},"paymentReference":{"type":["string","null"]},"paidAt":{"type":["string","null"]},"cancelledAt":{"type":["string","null"]},"requestedVia":{"type":"string","enum":["APP","API"]},"createdAt":{"type":"string"}},"required":["id","amount","currency","status","destination","note","reviewNote","paymentReference","paidAt","cancelledAt","requestedVia","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["PAYOUT_NOT_FOUND"]}},"/payouts/{payoutId}/cancel":{"post":{"operationId":"payouts.cancel","summary":"Cancel a pending payout","tags":["Money"],"security":[{"apiKey":[]},{"oauth":["payouts:write"]}],"x-scope":"payouts:write","parameters":[{"name":"payoutId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Cancel a pending payout","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"currency":{"type":"string"},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED","PROCESSING","PAID","FAILED","CANCELLED"]},"destination":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","BANK_ACCOUNT","PAYPAL","PAYONEER"]},"label":{"type":"string"},"summary":{"type":"string","description":"The account, masked: GB•• •••• 4821, •••• 0042, PayPal"}},"required":["type","label","summary"],"additionalProperties":false},"note":{"type":["string","null"]},"reviewNote":{"description":"Stillmore Group's note when approving or refusing","type":["string","null"]},"paymentReference":{"type":["string","null"]},"paidAt":{"type":["string","null"]},"cancelledAt":{"type":["string","null"]},"requestedVia":{"type":"string","enum":["APP","API"]},"createdAt":{"type":"string"}},"required":["id","amount","currency","status","destination","note","reviewNote","paymentReference","paidAt","cancelledAt","requestedVia","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["PAYOUT_NOT_FOUND","PAYOUT_NOT_PENDING"]}},"/organizations":{"get":{"operationId":"organizations.list","summary":"Organizations the key can act for","description":"The key's own organization, and the sub-labels below it when the key may act for them. To act for a sub-label, send its id in the Stillmore-Organization header: every id, list and limit is then that sub-label's, as if it had its own key.","tags":["Account"],"security":[{"apiKey":[]},{"oauth":[]}],"parameters":[{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Organizations the key can act for","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["LABEL","ARTIST","MANAGEMENT"]},"status":{"type":"string","enum":["ACTIVE","SUSPENDED"]},"parentId":{"type":["string","null"]},"depth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"0 for the key's own organization, 1 for its sub-labels, and so on"},"current":{"type":"boolean","description":"The organization this request acted for"}},"required":["id","name","kind","status","parentId","depth","current"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}}},"/releases/{releaseId}/smart-link":{"get":{"operationId":"smartLinks.get","summary":"The release's smart link","description":"The public page fans open to choose a store. null until one is made: by PUT, or when staff record store links at delivery.","tags":["Smart links"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"The release's smart link","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","description":"The public page"},"enabled":{"type":"boolean"},"headline":{"type":["string","null"]},"stores":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string","enum":["SPOTIFY","APPLE_MUSIC","YOUTUBE_MUSIC","AMAZON_MUSIC","DEEZER","TIDAL","SOUNDCLOUD","BANDCAMP","OTHER"]},"url":{"type":"string"},"label":{"type":["string","null"]}},"required":["store","url","label"],"additionalProperties":false}},"notifyMeEnabled":{"type":"boolean","description":"Fans can leave their email to hear when the release is out"},"notifiedAt":{"description":"When the \"it's out\" email went to them","type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","releaseId","slug","url","enabled","headline","stores","notifyMeEnabled","notifiedAt","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND"]},"put":{"operationId":"smartLinks.upsert","summary":"Make or change the smart link","description":"Made on the first call with the release title as its address unless you give a slug; later calls change only what they name.","tags":["Smart links"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"description":"The page address; unique across the platform","type":"string","minLength":3,"maxLength":60,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"enabled":{"type":"boolean"},"headline":{"anyOf":[{"type":"string","maxLength":140},{"type":"null"}]},"stores":{"description":"Replaces the page's store buttons, in order; https links only","maxItems":12,"type":"array","items":{"type":"object","properties":{"store":{"type":"string","enum":["SPOTIFY","APPLE_MUSIC","YOUTUBE_MUSIC","AMAZON_MUSIC","DEEZER","TIDAL","SOUNDCLOUD","BANDCAMP","OTHER"]},"url":{"type":"string","maxLength":500,"format":"uri"},"label":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]}},"required":["store","url"]}},"notifyMeEnabled":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Make or change the smart link","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","description":"The public page"},"enabled":{"type":"boolean"},"headline":{"type":["string","null"]},"stores":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string","enum":["SPOTIFY","APPLE_MUSIC","YOUTUBE_MUSIC","AMAZON_MUSIC","DEEZER","TIDAL","SOUNDCLOUD","BANDCAMP","OTHER"]},"url":{"type":"string"},"label":{"type":["string","null"]}},"required":["store","url","label"],"additionalProperties":false}},"notifyMeEnabled":{"type":"boolean","description":"Fans can leave their email to hear when the release is out"},"notifiedAt":{"description":"When the \"it's out\" email went to them","type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","releaseId","slug","url","enabled","headline","stores","notifyMeEnabled","notifiedAt","createdAt","updatedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND","SLUG_TAKEN"]}},"/releases/{releaseId}/smart-link/stats":{"get":{"operationId":"smartLinks.stats","summary":"Clicks and sign-ups","description":"Clicks per store and per day for the last 30 days, and fans waiting for the release.","tags":["Smart links"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Clicks and sign-ups","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"totalClicks":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"clicksByStore":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string","enum":["SPOTIFY","APPLE_MUSIC","YOUTUBE_MUSIC","AMAZON_MUSIC","DEEZER","TIDAL","SOUNDCLOUD","BANDCAMP","OTHER"]},"clicks":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["store","clicks"],"additionalProperties":false}},"clicksByDay":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"clicks":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["day","clicks"],"additionalProperties":false},"description":"The last 30 days that had clicks"},"subscribers":{"type":"object","properties":{"confirmed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pending":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["confirmed","pending"],"additionalProperties":false}},"required":["totalClicks","clicksByStore","clicksByDay","subscribers"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["RELEASE_NOT_FOUND"]}},"/cover-licenses":{"get":{"operationId":"coverLicenses.list","summary":"Cover licence requests","tags":["Cover licences"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"trackId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"name":"releaseId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["AWAITING_PAYMENT","AWAITING_DOCUMENT","PENDING","IN_PROGRESS","APPROVED","REJECTED","CANCELLED"]}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Cover licence requests","content":{"application/json":{"schema":{"type":"object","required":["data","hasMore","nextCursor"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string","description":"Our reference, e.g. CVL-2026-0042"},"releaseId":{"type":"string"},"trackId":{"type":"string"},"mode":{"type":"string","enum":["PURCHASE","OWN"],"description":"OWN: you send in a licence you have; PURCHASE: Stillmore Group gets one for you"},"status":{"type":"string","enum":["AWAITING_PAYMENT","AWAITING_DOCUMENT","PENDING","IN_PROGRESS","APPROVED","REJECTED","CANCELLED"]},"original":{"type":"object","properties":{"title":{"type":"string"},"artist":{"type":"string"},"writers":{"type":"array","items":{"type":"string"}},"publisher":{"type":["string","null"]},"isrc":{"type":["string","null"]},"link":{"type":["string","null"]}},"required":["title","artist","writers","publisher","isrc","link"],"additionalProperties":false,"description":"The song being covered"},"notes":{"type":["string","null"]},"price":{"type":"string","description":"USD; 0.00 for OWN"},"payWith":{"anyOf":[{"type":"string","enum":["CARD","WALLET"]},{"type":"null"}]},"document":{"anyOf":[{"type":"object","properties":{"fileName":{"type":"string"},"uploadedAt":{"type":["string","null"]}},"required":["fileName","uploadedAt"],"additionalProperties":false},{"type":"null"}],"description":"The licence file on the request"},"licenseRef":{"type":["string","null"]},"reason":{"description":"Why it was refused","type":["string","null"]},"paidAt":{"type":["string","null"]},"dueAt":{"type":["string","null"]},"decidedAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","number","releaseId","trackId","mode","status","original","notes","price","payWith","document","licenseRef","reason","paidAt","dueAt","decidedAt","createdAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor for the next page"}}}}}},"default":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"coverLicenses.create","summary":"Ask for a cover licence","description":"A track marked as a cover needs a mechanical licence before it goes to the stores. OWN: upload the licence you hold with …/document, Stillmore Group checks it for free. PURCHASE: Stillmore Group gets it for a fixed price, from the balance (WALLET, at once) or by card (a person pays at checkoutUrl). One open request per track.","tags":["Cover licences"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"trackId":{"type":"string","pattern":"^[a-f0-9]{24}$","description":"A track marked as a cover (isCover: true)"},"mode":{"type":"string","enum":["PURCHASE","OWN"]},"original":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160},"artist":{"type":"string","minLength":1,"maxLength":160},"writers":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"publisher":{"type":"string","maxLength":160},"isrc":{"type":"string","maxLength":20},"link":{"type":"string","maxLength":500,"format":"uri"}},"required":["title","artist","writers"],"additionalProperties":false},"payWith":{"description":"PURCHASE only: WALLET takes the price from the balance at once; CARD answers with a checkout link a person pays","type":"string","enum":["CARD","WALLET"]},"notes":{"type":"string","maxLength":2000}},"required":["trackId","mode","original"],"additionalProperties":false}}}},"responses":{"201":{"description":"Ask for a cover licence","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"license":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string","description":"Our reference, e.g. CVL-2026-0042"},"releaseId":{"type":"string"},"trackId":{"type":"string"},"mode":{"type":"string","enum":["PURCHASE","OWN"],"description":"OWN: you send in a licence you have; PURCHASE: Stillmore Group gets one for you"},"status":{"type":"string","enum":["AWAITING_PAYMENT","AWAITING_DOCUMENT","PENDING","IN_PROGRESS","APPROVED","REJECTED","CANCELLED"]},"original":{"type":"object","properties":{"title":{"type":"string"},"artist":{"type":"string"},"writers":{"type":"array","items":{"type":"string"}},"publisher":{"type":["string","null"]},"isrc":{"type":["string","null"]},"link":{"type":["string","null"]}},"required":["title","artist","writers","publisher","isrc","link"],"additionalProperties":false,"description":"The song being covered"},"notes":{"type":["string","null"]},"price":{"type":"string","description":"USD; 0.00 for OWN"},"payWith":{"anyOf":[{"type":"string","enum":["CARD","WALLET"]},{"type":"null"}]},"document":{"anyOf":[{"type":"object","properties":{"fileName":{"type":"string"},"uploadedAt":{"type":["string","null"]}},"required":["fileName","uploadedAt"],"additionalProperties":false},{"type":"null"}],"description":"The licence file on the request"},"licenseRef":{"type":["string","null"]},"reason":{"description":"Why it was refused","type":["string","null"]},"paidAt":{"type":["string","null"]},"dueAt":{"type":["string","null"]},"decidedAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","number","releaseId","trackId","mode","status","original","notes","price","payWith","document","licenseRef","reason","paidAt","dueAt","decidedAt","createdAt"],"additionalProperties":false},"checkoutUrl":{"description":"CARD purchases: where a person pays; the request starts once paid","type":["string","null"]}},"required":["license","checkoutUrl"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["TRACK_NOT_A_COVER","COVER_LICENSE_EXISTS","COVER_LICENSING_CLOSED","INSUFFICIENT_BALANCE"]}},"/cover-licenses/{licenseId}":{"get":{"operationId":"coverLicenses.get","summary":"One request","tags":["Cover licences"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"licenseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"One request","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string","description":"Our reference, e.g. CVL-2026-0042"},"releaseId":{"type":"string"},"trackId":{"type":"string"},"mode":{"type":"string","enum":["PURCHASE","OWN"],"description":"OWN: you send in a licence you have; PURCHASE: Stillmore Group gets one for you"},"status":{"type":"string","enum":["AWAITING_PAYMENT","AWAITING_DOCUMENT","PENDING","IN_PROGRESS","APPROVED","REJECTED","CANCELLED"]},"original":{"type":"object","properties":{"title":{"type":"string"},"artist":{"type":"string"},"writers":{"type":"array","items":{"type":"string"}},"publisher":{"type":["string","null"]},"isrc":{"type":["string","null"]},"link":{"type":["string","null"]}},"required":["title","artist","writers","publisher","isrc","link"],"additionalProperties":false,"description":"The song being covered"},"notes":{"type":["string","null"]},"price":{"type":"string","description":"USD; 0.00 for OWN"},"payWith":{"anyOf":[{"type":"string","enum":["CARD","WALLET"]},{"type":"null"}]},"document":{"anyOf":[{"type":"object","properties":{"fileName":{"type":"string"},"uploadedAt":{"type":["string","null"]}},"required":["fileName","uploadedAt"],"additionalProperties":false},{"type":"null"}],"description":"The licence file on the request"},"licenseRef":{"type":["string","null"]},"reason":{"description":"Why it was refused","type":["string","null"]},"paidAt":{"type":["string","null"]},"dueAt":{"type":["string","null"]},"decidedAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","number","releaseId","trackId","mode","status","original","notes","price","payWith","document","licenseRef","reason","paidAt","dueAt","decidedAt","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["COVER_LICENSE_NOT_FOUND"]}},"/cover-licenses/{licenseId}/document":{"post":{"operationId":"coverLicenses.document","summary":"Start uploading the licence file","description":"OWN requests: PDF, Word, JPEG or PNG up to 20 MB, also to answer a refusal.","tags":["Cover licences"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"licenseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"The file's name, with its extension"},"contentType":{"type":"string","minLength":3,"maxLength":120,"description":"image/jpeg or image/png for covers; audio/wav or audio/flac for masters"},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Exact size in bytes; the PUT must send the same Content-Length"}},"required":["fileName","contentType","sizeBytes"],"additionalProperties":false}}}},"responses":{"201":{"description":"Start uploading the licence file","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"uploadId":{"type":"string"},"uploadUrl":{"type":"string","description":"PUT the file's bytes here"},"method":{"type":"string","const":"PUT"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Send these headers with the PUT, and Content-Length equal to sizeBytes"},"expiresAt":{"type":"string","description":"Upload and complete before this time"}},"required":["uploadId","uploadUrl","method","headers","expiresAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["COVER_LICENSE_NOT_FOUND","COVER_LICENSE_STATE"]}},"/cover-licenses/{licenseId}/document/complete":{"post":{"operationId":"coverLicenses.documentComplete","summary":"Finish uploading the licence file","description":"The request goes to Stillmore Group (PENDING).","tags":["Cover licences"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"licenseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uploadId":{"type":"string","pattern":"^[a-f0-9]{24}$"},"durationSeconds":{"type":"number","minimum":0,"maximum":21600}},"required":["uploadId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Finish uploading the licence file","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string","description":"Our reference, e.g. CVL-2026-0042"},"releaseId":{"type":"string"},"trackId":{"type":"string"},"mode":{"type":"string","enum":["PURCHASE","OWN"],"description":"OWN: you send in a licence you have; PURCHASE: Stillmore Group gets one for you"},"status":{"type":"string","enum":["AWAITING_PAYMENT","AWAITING_DOCUMENT","PENDING","IN_PROGRESS","APPROVED","REJECTED","CANCELLED"]},"original":{"type":"object","properties":{"title":{"type":"string"},"artist":{"type":"string"},"writers":{"type":"array","items":{"type":"string"}},"publisher":{"type":["string","null"]},"isrc":{"type":["string","null"]},"link":{"type":["string","null"]}},"required":["title","artist","writers","publisher","isrc","link"],"additionalProperties":false,"description":"The song being covered"},"notes":{"type":["string","null"]},"price":{"type":"string","description":"USD; 0.00 for OWN"},"payWith":{"anyOf":[{"type":"string","enum":["CARD","WALLET"]},{"type":"null"}]},"document":{"anyOf":[{"type":"object","properties":{"fileName":{"type":"string"},"uploadedAt":{"type":["string","null"]}},"required":["fileName","uploadedAt"],"additionalProperties":false},{"type":"null"}],"description":"The licence file on the request"},"licenseRef":{"type":["string","null"]},"reason":{"description":"Why it was refused","type":["string","null"]},"paidAt":{"type":["string","null"]},"dueAt":{"type":["string","null"]},"decidedAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","number","releaseId","trackId","mode","status","original","notes","price","payWith","document","licenseRef","reason","paidAt","dueAt","decidedAt","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["COVER_LICENSE_NOT_FOUND","COVER_LICENSE_STATE","UPLOAD_NOT_RECEIVED"]}},"/cover-licenses/{licenseId}/cancel":{"post":{"operationId":"coverLicenses.cancel","summary":"Cancel a request not sent in yet","description":"Before payment (CARD) or before the file (OWN).","tags":["Cover licences"],"security":[{"apiKey":[]},{"oauth":["releases:write"]}],"x-scope":"releases:write","parameters":[{"name":"licenseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Cancel a request not sent in yet","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"string","description":"Our reference, e.g. CVL-2026-0042"},"releaseId":{"type":"string"},"trackId":{"type":"string"},"mode":{"type":"string","enum":["PURCHASE","OWN"],"description":"OWN: you send in a licence you have; PURCHASE: Stillmore Group gets one for you"},"status":{"type":"string","enum":["AWAITING_PAYMENT","AWAITING_DOCUMENT","PENDING","IN_PROGRESS","APPROVED","REJECTED","CANCELLED"]},"original":{"type":"object","properties":{"title":{"type":"string"},"artist":{"type":"string"},"writers":{"type":"array","items":{"type":"string"}},"publisher":{"type":["string","null"]},"isrc":{"type":["string","null"]},"link":{"type":["string","null"]}},"required":["title","artist","writers","publisher","isrc","link"],"additionalProperties":false,"description":"The song being covered"},"notes":{"type":["string","null"]},"price":{"type":"string","description":"USD; 0.00 for OWN"},"payWith":{"anyOf":[{"type":"string","enum":["CARD","WALLET"]},{"type":"null"}]},"document":{"anyOf":[{"type":"object","properties":{"fileName":{"type":"string"},"uploadedAt":{"type":["string","null"]}},"required":["fileName","uploadedAt"],"additionalProperties":false},{"type":"null"}],"description":"The licence file on the request"},"licenseRef":{"type":["string","null"]},"reason":{"description":"Why it was refused","type":["string","null"]},"paidAt":{"type":["string","null"]},"dueAt":{"type":["string","null"]},"decidedAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","number","releaseId","trackId","mode","status","original","notes","price","payWith","document","licenseRef","reason","paidAt","dueAt","decidedAt","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["COVER_LICENSE_NOT_FOUND","COVER_LICENSE_STATE"]}},"/sandbox/releases/{releaseId}/review":{"post":{"operationId":"sandbox.review","summary":"Play review","description":"Test keys only. Decides a submitted release as a reviewer would: APPROVE, REQUEST_CHANGES or REJECT, with the same status changes, review notes and events (release.approved, release.changes_requested, release.rejected).","tags":["Sandbox"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["APPROVE","REQUEST_CHANGES","REJECT"]},"note":{"description":"What the label reads; needed to request changes or reject","type":"string","minLength":3,"maxLength":500}},"required":["decision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Play review","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["SANDBOX_ONLY","INVALID_RELEASE_STATUS"]}},"/sandbox/releases/{releaseId}/deliver":{"post":{"operationId":"sandbox.deliver","summary":"Play delivery","description":"Test keys only. Sends an approved release to make-believe stores: LIVE gives it a UPC, ISRCs and store links (release.sent, release.codes_assigned, release.live, release.store_links_updated); REFUSED_BY_STORES refuses it with your reason (release.provider_rejected).","tags":["Sandbox"],"security":[{"apiKey":[]},{"oauth":["releases:read"]}],"x-scope":"releases:read","parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"outcome":{"default":"LIVE","type":"string","enum":["LIVE","REFUSED_BY_STORES"]},"reason":{"description":"For REFUSED_BY_STORES","type":"string","minLength":3,"maxLength":300}},"additionalProperties":false}}}},"responses":{"200":{"description":"Play delivery","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"labelId":{"type":"string"},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"type":{"type":"string","enum":["SINGLE","EP","ALBUM"]},"status":{"type":"string","enum":["DRAFT","LABEL_REVIEW","IN_REVIEW","CHANGES_REQUESTED","REJECTED","APPROVED","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN","ARCHIVED"],"description":"Where the release is, review and delivery together"},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"primaryGenre":{"type":["string","null"]},"secondaryGenre":{"type":["string","null"]},"language":{"type":["string","null"]},"explicit":{"type":"boolean"},"releaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"originalReleaseDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"copyright":{"type":"object","properties":{"cLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false},"pLine":{"type":"object","properties":{"year":{"type":["number","null"]},"holder":{"type":["string","null"]}},"required":["year","holder"],"additionalProperties":false}},"required":["cLine","pLine"],"additionalProperties":false},"territories":{"type":"object","properties":{"mode":{"type":"string","enum":["WORLDWIDE","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"stores":{"type":"object","properties":{"mode":{"type":"string","enum":["ALL","CUSTOM"]},"codes":{"type":"array","items":{"type":"string"}}},"required":["mode","codes"],"additionalProperties":false},"upc":{"type":["string","null"]},"artwork":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"width":{"type":["number","null"]},"height":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","width","height"],"additionalProperties":false},{"type":"null"}]},"trackCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tracks":{"description":"Included when one release is read, created or changed","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"releaseId":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"versionTitle":{"type":["string","null"]},"primaryArtistIds":{"type":"array","items":{"type":"string"}},"featuredArtistIds":{"type":"array","items":{"type":"string"}},"explicit":{"type":"boolean"},"isCover":{"type":"boolean"},"language":{"type":["string","null"]},"isrc":{"type":["string","null"]},"lyrics":{"type":["string","null"]},"credits":{"type":"object","properties":{"songwriters":{"type":"array","items":{"type":"string"}},"composers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"publishers":{"type":"array","items":{"type":"string"}},"mixers":{"type":"array","items":{"type":"string"}},"masteringEngineers":{"type":"array","items":{"type":"string"}},"remixers":{"type":"array","items":{"type":"string"}}},"required":["songwriters","composers","producers","publishers","mixers","masteringEngineers","remixers"],"additionalProperties":false},"audio":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["PENDING_UPLOAD","UPLOADED","VERIFIED","FAILED","DELETED"]},"fileName":{"type":["string","null"]},"mimeType":{"type":["string","null"]},"sizeBytes":{"type":["number","null"]},"uploadedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"durationSeconds":{"type":["number","null"]},"sampleRate":{"type":["number","null"]},"bitDepth":{"type":["number","null"]},"channels":{"type":["number","null"]}},"required":["status","fileName","mimeType","sizeBytes","uploadedAt","durationSeconds","sampleRate","bitDepth","channels"],"additionalProperties":false},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","releaseId","position","title","versionTitle","primaryArtistIds","featuredArtistIds","explicit","isCover","language","isrc","lyrics","credits","audio","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}},"review":{"description":"Included when one release is read, created or changed","type":"object","properties":{"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"decidedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"automatic":{"type":"boolean","description":"The account's automatic approval passed the release without a person"},"note":{"description":"What review asked for when it sent the release back, or why it rejected it","type":["string","null"]},"issues":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"message":{"type":"string"}},"required":["category","message"],"additionalProperties":false}},"documentsRequested":{"anyOf":[{"type":"object","properties":{"note":{"type":"string"},"requestedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"fulfilled":{"type":"boolean"}},"required":["note","requestedAt","fulfilled"],"additionalProperties":false},{"type":"null"}]}},"required":["submittedAt","decidedAt","automatic","note","issues","documentsRequested"],"additionalProperties":false},"delivery":{"description":"On its way to the stores, codes and store pages; included when one release is read, created or changed","type":"object","properties":{"status":{"type":"string","enum":["NOT_SENT","SENT_TO_STORES","LIVE","REFUSED_BY_STORES","TAKEDOWN_REQUESTED","TAKEN_DOWN"]},"sentAt":{"type":["string","null"]},"liveAt":{"type":["string","null"]},"refusedReason":{"type":["string","null"]},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string"},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"smartLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string"},"enabled":{"type":"boolean"}},"required":["url","enabled"],"additionalProperties":false},{"type":"null"}]}},"required":["status","sentAt","liveAt","refusedReason","storeLinks","smartLink"],"additionalProperties":false},"submittedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp in UTC"},{"type":"null"}]},"externalId":{"type":["string","null"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"createdAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp in UTC"},"revision":{"type":"string","description":"Changes whenever the record does; send it back in If-Match to refuse an update when someone else changed it first"}},"required":["id","labelId","title","versionTitle","type","status","primaryArtistIds","featuredArtistIds","primaryGenre","secondaryGenre","language","explicit","releaseDate","originalReleaseDate","copyright","territories","stores","upc","artwork","trackCount","submittedAt","approvedAt","externalId","metadata","createdAt","updatedAt","revision"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["SANDBOX_ONLY","RELEASE_NOT_APPROVED"]}},"/sandbox/royalties":{"post":{"operationId":"sandbox.royalties","summary":"Play a royalty month","description":"Test keys only. Reports gross royalties for a month over the sandbox's live releases (store and territory lines), publishes the statement and credits the balance (statement.published).","tags":["Sandbox"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"month":{"description":"The reporting month; last month by default","type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"},"gross":{"default":"250.00","description":"USD reported for the month, spread over the sandbox's live releases","type":"string","pattern":"^\\d{1,6}(\\.\\d{1,2})?$"}},"additionalProperties":false}}}},"responses":{"201":{"description":"Play a royalty month","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["PUBLISHED","VOID"],"description":"VOID: Stillmore Group withdrew it after publishing and a corrected statement follows; its lines and CSV answer 410"},"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"currency":{"type":"string"},"gross":{"type":"string","description":"What the stores reported for the period"},"fees":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"net":{"type":"string","description":"What was credited to the balance"},"revenueSharePercent":{"description":"The organization's share applied, when an agreement set one","type":["string","null"]},"version":{"type":"number"},"publishedAt":{"type":["string","null"]}},"required":["id","status","periodStart","periodEnd","currency","gross","fees","net","revenueSharePercent","version","publishedAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["SANDBOX_ONLY","NOTHING_LIVE","STATEMENT_EXISTS"]}},"/sandbox/payouts/{payoutId}/pay":{"post":{"operationId":"sandbox.payPayout","summary":"Play paying a payout","description":"Test keys only. Approves and pays a pending payout request (payout.approved, payout.paid), taking it off the balance.","tags":["Sandbox"],"security":[{"apiKey":[]},{"oauth":["finance:read"]}],"x-scope":"finance:read","parameters":[{"name":"payoutId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"responses":{"200":{"description":"Play paying a payout","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"string","description":"A decimal amount in its currency, e.g. \"1250.40\""},"currency":{"type":"string"},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED","PROCESSING","PAID","FAILED","CANCELLED"]},"destination":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","BANK_ACCOUNT","PAYPAL","PAYONEER"]},"label":{"type":"string"},"summary":{"type":"string","description":"The account, masked: GB•• •••• 4821, •••• 0042, PayPal"}},"required":["type","label","summary"],"additionalProperties":false},"note":{"type":["string","null"]},"reviewNote":{"description":"Stillmore Group's note when approving or refusing","type":["string","null"]},"paymentReference":{"type":["string","null"]},"paidAt":{"type":["string","null"]},"cancelledAt":{"type":["string","null"]},"requestedVia":{"type":"string","enum":["APP","API"]},"createdAt":{"type":"string"}},"required":["id","amount","currency","status","destination","note","reviewNote","paymentReference","paidAt","cancelledAt","requestedVia","createdAt"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["SANDBOX_ONLY","PAYOUT_NOT_FOUND","PAYOUT_NOT_PENDING"]}},"/sandbox/reset":{"post":{"operationId":"sandbox.reset","summary":"Empty the sandbox","description":"Test keys only. Deletes everything made in the sandbox: catalogue, files, smart links, licences, statements, ledger, payouts and events. Webhook endpoints and keys stay.","tags":["Sandbox"],"security":[{"apiKey":[]},{"oauth":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Organization"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirm":{"type":"boolean","const":true,"description":"Send true: everything in the sandbox is deleted"}},"required":["confirm"],"additionalProperties":false}}}},"responses":{"200":{"description":"Empty the sandbox","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"deleted":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"description":"How many records of each kind went"}},"required":["deleted"],"additionalProperties":false}}}}}},"default":{"$ref":"#/components/responses/Error"}},"x-error-codes":["SANDBOX_ONLY"]}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key from the workspace's API tab: sm_live_… (or sm_test_… for the sandbox)."},"oauth":{"type":"oauth2","description":"An app's access token (sm_oat_…), from the authorization code flow with PKCE (S256).","flows":{"authorizationCode":{"authorizationUrl":"https://app.stillmoregroup.com/oauth/authorize","tokenUrl":"https://api.stillmoregroup.com/api/oauth/token","refreshUrl":"https://api.stillmoregroup.com/api/oauth/token","scopes":{"releases:read":"Releases, their tracks, review and delivery status, codes and store links.","releases:write":"Drafts, tracks, splits, artwork and audio files.","releases:submit":"Submit releases for review and ask for takedowns.","artists:read":"The organization's artist roster.","artists:write":"Add artists to the roster and change their details.","labels:read":"The organization's labels and imprints.","labels:write":"Add labels and imprints and change their details.","finance:read":"Balance, ledger, earnings, published royalty statements and payouts.","payouts:write":"Ask for payouts to the organization's saved payout methods, once an owner or admin allows it in the API tab.","webhooks:manage":"Register, change and test webhook endpoints."}}}}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":255},"description":"Any unique value (a UUID); a retry with the same key and body gets the first answer again for 24 hours."},"IfMatch":{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"},"description":"The revision (ETag) you read; an older one answers 412 REVISION_MISMATCH."},"Organization":{"name":"Stillmore-Organization","in":"header","required":false,"schema":{"type":"string"},"description":"A sub-label to act for, when the key may (GET /organizations)."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","requestId"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","conflict_error","idempotency_error","rate_limit_error","service_unavailable_error","api_error"]},"code":{"type":"string","examples":["API_KEY_REQUIRED","INVALID_API_KEY","API_KEY_REVOKED","API_KEY_EXPIRED","API_KEY_PAUSED","API_KEY_OWNER_INACTIVE","API_ACCESS_DISABLED","INVALID_ORGANIZATION_HEADER","SUB_LABELS_NOT_ALLOWED","SUB_LABEL_NOT_ALLOWED","SANDBOX_ONLY","SANDBOX_NO_SUB_LABELS","OAUTH_TOKEN_INVALID","OAUTH_TOKEN_EXPIRED","OAUTH_CONNECTION_REVOKED","OAUTH_APP_SUSPENDED","OAUTH_MEMBER_INACTIVE","IP_NOT_ALLOWED","INSUFFICIENT_SCOPE","OWNER_PERMISSION_MISSING","TOO_MANY_FAILED_ATTEMPTS","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","INVALID_ID","ROUTE_NOT_FOUND","INVALID_CURSOR","REVISION_MISMATCH","EXTERNAL_ID_IN_USE","UPC_IN_USE","LABEL_ARCHIVED","API_PAYOUTS_OFF","SUBMISSION_LIMIT_REACHED","RELEASE_SUBMISSION_INVALID","UPLOAD_NOT_RECEIVED","ARTWORK_CMYK","IMPORT_URL_NOT_ALLOWED","IMPORT_FAILED","IMPORT_TOO_LARGE","IMPORT_TIMED_OUT","STATEMENT_VOID","IDEMPOTENCY_KEY_INVALID","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_IN_PROGRESS","MAINTENANCE","MAINTENANCE_READ_ONLY","DATABASE_UNAVAILABLE","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{},"requestId":{"type":"string"}}}}}},"responses":{"Error":{"description":"Every error has this shape; the X-Request-Id header repeats requestId.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}