Browse the Help Center for platform guides or API & Developers for integration docs.
curl --request POST \
--url https://open.beatpass.ca/api/v1/albums \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "My New Album",
"description": "A collection of great songs",
"release_date": "2024-01-01",
"artist_id": 1
}
'{
"status": "success",
"album": {
"id": 123,
"name": "Coda",
"image": "https://example.com/image1.jpg",
"release_date": "1982-11-19",
"description": "<string>",
"tracks": [
{
"id": 123,
"name": "Hey Hey What Can I Do",
"release_date": "1982-11-19",
"image": "https://example.com/image1.jpg",
"duration": 5645848548,
"description": "<string>",
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
],
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
}curl --request POST \
--url https://open.beatpass.ca/api/v1/albums \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "My New Album",
"description": "A collection of great songs",
"release_date": "2024-01-01",
"artist_id": 1
}
'{
"status": "success",
"album": {
"id": 123,
"name": "Coda",
"image": "https://example.com/image1.jpg",
"release_date": "1982-11-19",
"description": "<string>",
"tracks": [
{
"id": 123,
"name": "Hey Hey What Can I Do",
"release_date": "1982-11-19",
"image": "https://example.com/image1.jpg",
"duration": 5645848548,
"description": "<string>",
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
],
"artists": [
{
"id": 123,
"name": "Led Zeppelin",
"image_small": "https://example.com/image1.jpg",
"verified": true
}
]
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Album created successfully
"success"
Show child attributes
"Coda"
Artwork image for album, usually 300x300px in size
"https://example.com/image1.jpg"
Release date of the album in YYYY-MM-DD format
"1982-11-19"
description for the album
Tracks of the album
Show child attributes
"Hey Hey What Can I Do"
Release date of the album in YYYY-MM-DD format
"1982-11-19"
Artwork image for album, usually 300x300px in size
"https://example.com/image1.jpg"
Duration for track in milliseconds
5645848548
description for the track
List of artists who performed the track
Show child attributes
"Led Zeppelin"
Small image for artist, usually 320x320px in size.
"https://example.com/image1.jpg"
Whether artist has been verified by SITE_NAME staff
true
Artists of the album
Show child attributes
Was this page helpful?