/v0/lists (POST)

POST

/v0/lists

const url = 'http://localhost:3000/v0/lists';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"title":"Pulsate developers","public":false}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url http://localhost:3000/v0/lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "title": "Pulsate developers", "public": false }'

Authorizations

bearer

Request Body

application/json

object

title

required

List title (1-100 characters)

string

Example

Pulsate developers

public

If true, list is public

boolean

Example

false

Responses

200

application/json

object

required

List ID

string

title

required

List title

string

public

If true, list is public

boolean

Example

{
  "id": "38477395",
  "title": "Pulsate developers",
  "public": false
}

400

Bad request

application/json

List title too long

object

error

required

List title is too long

string

Allowed values: TITLE_TOO_LONG

Example

{
  "error": "TITLE_TOO_LONG"
}

500

Internal error

application/json

Internal server error

object

error

required

Internal server error

string

Allowed values: INTERNAL_ERROR

Example

{
  "error": "INTERNAL_ERROR"
}