Update a list

​

Changes a list's settings. Send only the fields you want to change; the rest are left as they are.

This updates the list itself, not its cards. Add or remove cards with POST /v1/lists/{listId}/items and DELETE /v1/lists/{listId}/items/{itemId}.

Requires the lists:write scope.

Path Parameters
  • listId
    Type: string
    min length:  
    1
    required

    The list's id. Path parameter.

Body
application/json
  • currency
    Type: string enum

    The currency your wantPrice and sellPrice values are in. Omit to leave it unchanged.

    values
    • USD
    • EUR
    • CAD
    • AED
    • AUD
  • defaultLanguage
    Type: string enum

    The language applied to new cards when you don't set one. Omit to leave it unchanged.

    values
    • en
    • fr
    • de
    • it
    • es
  • defaultMinCondition
    Type: string · enum

    The minimum condition applied to new cards when you don't set one. Omit to leave it unchanged.

    values
    • NM

      Near Mint.

    • LP

      Lightly Played.

    • MP

      Moderately Played.

    • HP

      Heavily Played.

    • DMG

      Damaged.

  • description
    Type: string

    A new note for the list. Omit to leave it unchanged.

  • isPublic
    Type: boolean

    true makes the list public, false makes it private. Omit to leave it unchanged.

  • name
    Type: string
    min length:  
    1

    A new name for the list. Omit to leave it unchanged.

  • status
    Type: string enum

    A new status for the list. Omit to leave it unchanged.

    values
    • forSale

      Cards you're offering for sale.

    • toComplete

      Cards you're working to complete, such as a want list or a deck in progress.

    • hold

      Cards you're keeping aside.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for patch/lists/{listId}
curl 'https://public-api.cardnexus.com/v1/lists/{listId}' \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "name": "",
  "description": "",
  "status": "forSale",
  "isPublic": true,
  "defaultMinCondition": "NM",
  "defaultLanguage": "en",
  "currency": "USD"
}'

{
  "id": "6512a0b4e1d2c3f4a5b6c7d8",
  "name": "Modern deck — missing pieces",
  "game": "mtg",
  "status": "toComplete",
  "description": "Cards I still need for the Modern burn deck.",
  "bannerUrl": "https://ik.imagekit.io/cardnexus/production/mtg/mh2-137-front.png",
  "completionPercentage": 64,
  "itemCount": 2,
  "totalQuantity": 5,
  "isPublic": false,
  "currency": "USD",
  "defaultMinCondition": "NM",
  "defaultLanguage": "en",
  "createdAt": "2026-03-11T09:15:00.000Z",
  "updatedAt": "2026-06-28T14:02:47.000Z",
  "items": [
    {
      "id": "665f3a2b1c8d4e9f7a6b5c4d",
      "productId": 71044,
      "name": "Lightning Bolt",
      "nameSlug": "lightning-bolt",
      "expansion": "Modern Horizons 2",
      "finish": "Standard",
      "language": "en",
      "minCondition": "LP",
      "quantity": 4,
      "quantityFulfilled": 3,
      "wantPrice": 1.75,
      "sellPrice": null
    },
    {
      "id": "665f3a2b1c8d4e9f7a6b5c4e",
      "productId": 50212,
      "name": "Ragavan, Nimble Pilferer",
      "nameSlug": "ragavan-nimble-pilferer",
      "expansion": "Modern Horizons 2",
      "finish": "Foil",
      "language": "en",
      "minCondition": "NM",
      "quantity": 1,
      "quantityFulfilled": 0,
      "wantPrice": 60,
      "sellPrice": null
    }
  ]
}

List updated.