Sign in
Game Data - Wishlists

Add item to wishlist

Changed on

Add item to wishlist

Adds a new item to the wishlist with specified quantity, quality, and priority. Supports both craftable and non-craftable items.

Requirements:

  • 46.7: Add item to wishlist
  • 53.5: Support priority levels
  • 53.6: Support quality tier specification
  • 53.7: Support notes
post/game-data/wishlists/{wishlist_id}/items

Request

  • Base URL: /api/v2 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/game-data/wishlists/{wishlist_id}/items
  • Auth: loggedin (a scheme the document does not define)

Path parameters

wishlist_idstring required

Wishlist UUID

Request body

game_item_idstring required

Game item ID

desired_quantitynumber double required

Desired quantity

desired_quality_tiernumber double

Desired quality tier (1-5)

blueprint_idstring

Optional blueprint ID if item is craftable

acquisition_mode'buy' | 'craft'

How the user intends to acquire this item

  • "buy": Purchase the finished item from the market
  • "craft": Craft the item — ingredients will be added to the shopping list
prioritynumber double required

Priority level (1-5, higher is more important)

notesstring

Optional notes

Response

Created wishlist item

item_idstring required
wishlist_idstring required
game_item_idstring required
desired_quantitynumber double required
desired_quality_tiernumber double
blueprint_idstring
acquisition_mode'buy' | 'craft' required

How the user intends to acquire this item

  • "buy": Purchase the finished item from the market
  • "craft": Craft the item — ingredients will be added to the shopping list
prioritynumber double required
notesstring
is_acquiredboolean required
acquired_quantitynumber double required
created_atstring required
updated_atstring required
game_item_namestring required
game_item_iconstring
game_item_typestring required
blueprint_namestring
estimated_costnumber double
crafting_availableboolean required

Changes

  • v2a3060250b39bRevision changes
    • ○

      the endpoint scheme security loggedin was added to the API

    • ○

      the endpoint scheme security jwt was removed from the API

    • ○

      added the new optional request property

    • ○

      added the required property to the response with the status