1. Lists
Ludoria
  • Back to home
  • Residents
  • Lists
    • liked games lists
      • Retrieve a list
      • List all games from list
      • Like a game
      • Update a list
      • Remove game from list
    • played games lists
      • List all played games
      • Retrieve a played game
      • Add a played game
      • Update a played game
      • Remove a played game
    • List all lists
      GET
    • Retrieve a list
      GET
    • Create a list
      POST
    • Add game to list
      PUT
    • Update a list
      PATCH
    • Delete a list
      DELETE
    • Remove game from list
      DELETE
  • Reviews
    • List all reviews
      GET
    • Retrieve a review
      GET
    • Add a review
      POST
    • Update a review
      PATCH
    • Delete a review
      DELETE
  • Ratings
    • List all ratings
      GET
    • Retrieve a rating
      GET
    • Add a rating
      POST
    • Upsert a rating
      PUT
    • Update a rating
      PATCH
    • Delete a rating
      DELETE
  • Game Stats
    • List a resident's stats per game
      GET
  • Library
    • Get library visibility settings
      GET
    • List game library statuses as virtual lists
      GET
    • Update library visibility settings
      PATCH
    • List library entries for a resident
      GET
    • Add or upsert a library entry
      PUT
    • Get a library entry
      GET
    • Update a library entry
      PATCH
    • Remove a library entry
      DELETE
  • Liked Games
    • Get liked games for a resident
    • Like a game
    • Update liked-games visibility
    • Unlike a game
  • Deleted
    • obfuscates data
  • List all residents
    GET
  • Retrieve resident profile
    GET
  • Create a resident
    POST
  • Update a resident
    PATCH
  • Deletion request
    DELETE
  • Delete a resident
    DELETE
  • Follow a resident
    POST
  • Unfollow a resident
    DELETE
  1. Lists

Create a list

POST
/v1/residents/{id}/lists
listsresidents
Last modified:2026-05-27 01:39:15
Maintainer:JoseMa Esparza

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Header Params

Body Params application/json

Example
{
    "name": "Natalia Gurule Sanches",
    "description": "Batanar Incorruptamente Basural. Cencerrada Batán Cenefa Increado Descercador. Gemir Incorrectamente Batanga Deschapar Gemoterapia Batallaroso Incorporar Cenagoso. Abajamiento Descercar Engastar Incorrupto Engarrar. Genciana Cencapa Batallola Generalato Engargolar Generable Geminar Incorrectamente Incorregiblemente Descerrajar. Engarzador Batalán Batanear Fideicomisario Cendrazo Abacial Ficoideo.",
    "is_public": false
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://localhost:4002/rest/v1/residents/1/lists' \
--header 'X-Nexus-Key: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Natalia Gurule Sanches",
    "description": "Batanar Incorruptamente Basural. Cencerrada Batán Cenefa Increado Descercador. Gemir Incorrectamente Batanga Deschapar Gemoterapia Batallaroso Incorporar Cenagoso. Abajamiento Descercar Engastar Incorrupto Engarrar. Genciana Cencapa Batallola Generalato Engargolar Generable Geminar Incorrectamente Incorregiblemente Descerrajar. Engarzador Batalán Batanear Fideicomisario Cendrazo Abacial Ficoideo.",
    "is_public": false
}'

Responses

🟢201Created
application/json
Bodyapplication/json

Example
{
    "id": "lst_Xsx74nAI7x8L9ZvB",
    "slug": "my-favorite-xbox-games",
    "name": "My favorite Xbox Games",
    "description": null,
    "is_public": false,
    "total_items": 0,
    "resident_id": "res_PoCDmWaP9uxxkStu",
    "created_at": "2025-05-05T19:30:37.163Z",
    "updated_at": "2025-05-05T19:30:37.163Z"
}
🟠400Bad Request
🟠401Unathorized
🟠404Not Found
🔴500Server Error
Modified at 2026-05-27 01:39:15
Previous
Retrieve a list
Next
Add game to list
Built with