Skip to content

CreateArtistAgreement

Trevor Scandalios edited this page Aug 15, 2022 · 6 revisions

Generate an artist agreement

Generates a legal agreement for a NEWM song token.

Request

URL: /v1/artist-agreement

Method: POST

Path Parameters: None

Query Parameters: None

Headers:

Accept: application/json

Authorization: Bearer {accessToken}

Content:

Field Type Description Requirement Type
songName string Name of the song Required
artistName string Legal name of the artist Required
stageName string Stage name used by the artist Optional
companyName string Legal name of the company Optional

Content example:

{
    "songName": "Hello world",
    "artistName": "John Smith",
    "stageName": "Elvis",
    "companyName": "NFT Records"
}

✅ Success Response

Code: 200 OK

Headers:

Content-Type: application/json

Content:

Field Type Description Condition
pdf string base64 encoded string of the generated PDF Always

Content example:

{
    "pdf": "SGVsbG8gd29ybGQ="
}

❌ Error Responses

1. Invalid token

Code: 401 UNAUTHORIZED

Condition: JWT authentication token is invalid

Headers:

Content-Type: application/json

Content example:

{
    "code": 401,
    "description": "Invalid token"
}

2. Expired token

Code: 401 UNAUTHORIZED

Condition: JWT authentication token is expired

Headers:

Content-Type: application/json

Content example:

{
    "code": 401,
    "description": "Expired token"
}