{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/codai-ro/json-schema/codai-ro-list-schema.json",
  "title": "List",
  "description": "A list. Presets (`inbox`, `wishlist`, `notes`) cannot be deleted; your own lists have `preset` = `custom`.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/codai-ro-lists-api-openapi.yml#/components/schemas/List",
  "type": "object",
  "required": [
    "id",
    "name",
    "preset",
    "icon",
    "color",
    "position",
    "show_in_share",
    "price_watch",
    "archived",
    "created_at",
    "updated_at"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string"
    },
    "preset": {
      "type": "string",
      "enum": [
        "inbox",
        "wishlist",
        "notes",
        "custom"
      ]
    },
    "icon": {
      "type": [
        "string",
        "null"
      ]
    },
    "color": {
      "type": [
        "string",
        "null"
      ]
    },
    "position": {
      "type": "integer"
    },
    "show_in_share": {
      "type": "boolean",
      "description": "Shown as a target in the OS share sheet, the hub share page and the desktop hotkey."
    },
    "price_watch": {
      "type": "boolean",
      "description": "Daily price and stock check of the list's product links."
    },
    "archived": {
      "type": "boolean"
    },
    "item_count": {
      "type": "integer",
      "description": "Number of open items, when the endpoint computes it."
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}