Create new items for a specific list and related lists. Items will be added to the item set associated with the list.

Take the list id from the url on the Make a List page for your list. Your topic id can be taken from the url on your lists page. It will look something like “oliver-user”.

curl -X POST "<https://unduel.com/api/v1/list/create-items?user=><user name>" \\
  -H "X-API-Key: <api key>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "listId": "<list id>",
    "topicId": "<topic id>",
    "items": [
      {
        "id": "",
        "name": "Item Name",
        "subtitle": "Item Subtitle",
        "nameRef": "",
        "imageUrl": "<https://example.com/image.jpg>",
        "imageWidth": 300,
        "imageHeight": 300,
        "pixelated": false,
        "description": "Item description",
        "tags": ["tag1", "tag2"],
        "properties": {"key": "value"},
        "source": "<https://source.com>",
        "externalLinks": [{
            "url": "<https://en.wikipedia.org/wiki/New_Item>",
            "label": null,
            "externalLinkTypeName": "WIKI"
        }],
        "isEdited": false,
        "isArchived": false,
        "shouldDelete": false,
        "shouldResetRankings": false
      }
    ]
  }'

interface CreateItemsRequestBody {
  listId: string;
  topicId: string;
  items: EditableItem[];
}

interface EditableItem {
  /** Item ID (can be empty string for new items) */
  id: string;
  
  /** Item name */
  name: string;
  
  /** Optional subtitle */
  subtitle: string | null;
  
  /** URL-safe slug (can be empty, will be auto-generated) */
  nameRef: string;
  
  /** Image URL */
  imageUrl: string | null;
  
  /** Image dimensions */
  imageWidth: number | null;
  imageHeight: number | null;
  
  /** Is the image pixel art?  */
  pixelated: boolean | null;
  
  /** Item description */
  description: string | null;
  
  /** Array of tag names to apply for filtering */
  tags: string[];
  
  /** Custom properties as key-value pairs */
  properties: { [key: string]: string };
  
  /** Source of information for item */
  source: string | null;
  
  /** Ignored during creation */
  isEdited: boolean;
  
  /** Set to true to archive item */
  isArchived: boolean;
  
  /** Ignored during creation */
  shouldDelete: boolean;
  
  /** Ignored during creation */
  shouldResetRankings: boolean;
  
  /** Urls for external web pages relating to the item */
  externalLinks: ExternalLinkMinimal[];
  
  wikiUrl: string | null; // DEPRECATED
}

interface ExternalLinkMinimal {
		/** The external link url */
    url: string;
    
    /** A label to override the type label */
    label: string | null;
    
    /** Specifies the type of link, if applicable */
    externalLinkTypeName: "WIKI" | "SPOTIFY" | "YOUTUBE" | null;
}

interface CreateItemsResponse {
  success: boolean;
  message?: string;
  error?: string;
}