Artists

Everything about Argentine Rock artists

---

Get all artists

GET

/api/v1/artists

Get a list of all legendary Argentine Rock artists and explore their contributions to the music scene.

Parameters

Query Parameters

limit

The number of items to return

Typeinteger

Format"int64"

Default10

offset

The number of items to skip before starting to collect the result set

Typeinteger

Format"int64"

Default0

Responses

OK

Content-Type

application/json

{

"data": [

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

],

"meta": {

"limit": 10,

"offset": 0,

"total": 100,

"next": "/artists?limit=10&offset=10"

}

}

GET

/api/v1/artists

Playground

Variables

Key

Value

limit

offset

Samples

---

Add a new artist

POST

/api/v1/artists

Add a new legendary Argentine Rock artist. Make sure they truly deserve the title!

Authorizations

bearerAuth

TypeHTTP (bearer)

or

apiKeyHeader

TypeAPI Key (header: X-API-Key)

Request Body

application/json

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

Responses

Created

Content-Type

application/json

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

POST

/api/v1/artists

Playground

Authorization

bearerAuth

Body

Samples

---

Get an artist

GET

/api/v1/artists/{artistId}

Learn more about a specific Argentine Rock artist and their legacy.

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Format"int64"

Responses

Artist Found

Content-Type

application/json

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

GET

/api/v1/artists/{artistId}

Playground

Variables

Key

Value

artistId*

Samples

---

Update an artist

PUT

/api/v1/artists/{artistId}

Update the information of a legendary Argentine Rock artist. Make sure to provide accurate data.

Authorizations

bearerAuth

TypeHTTP (bearer)

or

apiKeyHeader

TypeAPI Key (header: X-API-Key)

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Format"int64"

Request Body

application/json

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

Responses

OK

Content-Type

application/json

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

PUT

/api/v1/artists/{artistId}

Playground

Authorization

bearerAuth

Variables

Key

Value

artistId*

Body

Samples

---

Deprecated

Delete an artist

DELETE

/api/v1/artists/{artistId}

This endpoint was used to delete artists. Unfortunately, that caused a lot of controversy. So, this endpoint is now deprecated and should not be used anymore.

Authorizations

bearerAuth

TypeHTTP (bearer)

or

apiKeyHeader

TypeAPI Key (header: X-API-Key)

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Format"int64"

Responses

Bad Request

Content-Type

application/json

{

"type": "https://example.com/errors/generic-error",

"title": "Something went wrong here.",

"status": 403,

"detail": "Unfortunately, we can’t provide further information."

}

DELETE

/api/v1/artists/{artistId}

Playground

Authorization

bearerAuth

Variables

Key

Value

artistId*

Samples

---

Get all albums

GET

/api/v1/artists/{artistId}/albums

Get a list of all albums from a legendary Argentine Rock artist.

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Format"int64"

Query Parameters

limit

The number of items to return

Typeinteger

Format"int64"

Default10

offset

The number of items to skip before starting to collect the result set

Typeinteger

Format"int64"

Default0

Responses

OK

Content-Type

application/json

{

"data": [

{

"id": 1,

"name": "La Máquina de Hacer Pájaros",

"year": 1976,

"image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"

}

],

"meta": {

"limit": 10,

"offset": 0,

"total": 100,

"next": "/artists?limit=10&offset=10"

}

}

GET

/api/v1/artists/{artistId}/albums

Playground

Variables

Key

Value

artistId*

limit

offset

Samples

---

Add a new album

POST

/api/v1/artists/{artistId}/albums

Add a new album to a legendary Argentine Rock artist. Make sure it’s a masterpiece!

Authorizations

bearerAuth

TypeHTTP (bearer)

or

apiKeyHeader

TypeAPI Key (header: X-API-Key)

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Format"int64"

Request Body

application/json

{

"id": 1,

"name": "La Máquina de Hacer Pájaros",

"year": 1976,

"image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"

}

Responses

Created

Content-Type

application/json

{

"id": 1,

"name": "La Máquina de Hacer Pájaros",

"year": 1976,

"image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"

}

POST

/api/v1/artists/{artistId}/albums

Playground

Authorization

bearerAuth

Variables

Key

Value

artistId*

Body

Samples

---

Powered by VitePress OpenAPI