add_inventory_item
Add an item to your personal inventory with status (owned, wanted, for-sale), quantity, price, and notes. Use product ID or freeform name.
Instructions
Add an item to the caller's personal inventory. Requires an API key.
One creation tool covers all lifecycle states — set status to
match the user's intent: "I bought" → owned, "I want" →
wanted, "I'm selling" → for_sale. Either product_id or
name must be set. Not idempotent.
Args:
api_key: Partle API key (prefix pk_).
name: Freeform name for items not yet linked to a Partle product.
product_id: Link to a canonical Partle product.
status: Lifecycle. Default owned.
quantity: How many. Fractional ok. Default 1.
notes: Freeform multi-line text — the dumping ground for anything
not modeled as a column: extra URLs, comments, where stored,
condition narrative, purpose, source, history, log entries.
Markdown is fine. Put extra URLs here, not in another field.
acquisition_price: What you paid.
acquisition_currency: Currency of acquisition_price.
purchased_at: ISO date (YYYY-MM-DD).
asking_price: For status=for_sale.
asking_currency: Currency of asking_price.
condition: Free string — typical: new, like_new,
good, fair, poor.
external_link: Primary click-through URL only (source listing,
vendor page, manufacturer page). Exactly one. Additional URLs
go in notes as markdown links.
external_id: Stable identifier from the source system, used as a
dedup key. Per-user unique when set — same external_id
can't appear twice for one user. Format is up to you (e.g.
aliexpress:1005004714348221, amazon:order/.../line/1,
content hash). Leave null for handwritten items.
project: Tag for grouping.
Returns: The created inventory row.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | Yes | ||
| name | No | ||
| product_id | No | ||
| status | No | owned | |
| quantity | No | ||
| notes | No | ||
| acquisition_price | No | ||
| acquisition_currency | No | ||
| purchased_at | No | ||
| asking_price | No | ||
| asking_currency | No | ||
| condition | No | ||
| external_link | No | ||
| external_id | No | ||
| project | No |