Nifty

Add labels to one or more inventory items.

add_labels_action

Applies all of an inventory item's pending edits to the item in a single action and republishes its listings. To leave a pending edit out, discard it first. Nothing is applied if any pending edit is stale (the item or listing changed after the edit was made) or invalid — make the offending edits again and apply once more. Edits to listed items are applied and republished to the marketplaces asynchronously, typically within ~10-15 seconds.

apply_item_edits_action

Create a new label.

create_label_action

Permanently delete a label and remove it from all inventory items it is applied to. The items themselves are not affected.

delete_label_action

Discard pending (not yet applied) edits on an inventory item — the given editIds, or all of the item's pending edits when editIds is omitted. Discarding never changes the live item; clearing a field's live value is an edit, not a discard.

discard_pending_edits

Edit fields on an inventory item. Each edit becomes a pending edit: nothing is applied to the item or its listings until apply_item_edits_action applies all pending edits at once. get_pending_edits lists them and discard_pending_edits removes them. Editing the same field again replaces its pending value. Always call get_inventory_item first to get current values and listing IDs. For text changes (title, description, condition), call get_edit_item_instructions first and follow the returned instructions. Avoid discarding existing valuable details (measurements, flaws, etc.) unless the user asks for a full rewrite. Editable fields: title, description, condition, condition description, quantity, cost of goods (COGS), SKU, and per-listing price. All except per-listing price apply uniformly to every marketplace listing. Marketplace-specific attributes (tags, brand, color, size, material), category, shipping settings, and photos/videos are NOT editable here, and fields cannot be cleared. Only included fields change; string fields must be non-empty. The response lists every pending edit and whether the set can currently be applied; problems reported there are fixed by editing the field again.

edit_item

Get the current status of a previously started action, using the actionId the action tool returned. Use this when an action tool returned status RUNNING: wait a moment and poll this tool instead of retrying the action.

get_action_status

Return a sales & profit dashboard for a date range. Each metric includes the previous period (same length, immediately before) for comparison.

get_analytics_overview

Load instructions for editing an inventory item's title, description, and condition. Call this before writing or rewriting any text fields. Returns listing guidelines and the seller's custom instructions (if any).

get_edit_item_instructions

Return full details for one inventory item.

get_inventory_item