Update Inventory | Papertracc Docs

curl -X PATCH https://api.papertracc.com/v1/sales/inventory/id \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "type": "GOODS",
  "name": "Office Desk Pro",
  "usage": "SALE_AND_PURCHASE",
  "sales_account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
  "purchase_account_id": "e35f42b4-a6e2-4664-96df-d2cf3f1a6f33",
  "sales_description": "Office desk sold to customers",
  "purchase_description": "Office desk purchased from vendors",
  "sales_tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
  "purchase_tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
  "purchase_vendor_id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
  "tax_inclusive": true,
  "cost_prices": [
    {
      "rate": 120000,
      "currency_code": "NGN"
    }
  ],
  "selling_prices": [
    {
      "rate": 175000,
      "currency_code": "NGN"
    }
  ]
}'

{
  "data": {
    "id": "55a40b4d-a23a-49aa-a417-828913e9a5c8",
    "sku": "SKU-1001",
    "name": "Office Desk Pro",
    "type": "GOODS",
    "usage": "SALE_AND_PURCHASE",
    "amount": "150000.00",
    "created_at": "2026-06-18T10:00:00Z",
    "project_id": "spruce-demo",
    "cost_prices": [
      {
        "rate": 100000,
        "currency_code": "NGN"
      }
    ],
    "sales_tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
    "selling_prices": [
      {
        "rate": 150000,
        "currency_code": "NGN"
      }
    ],
    "purchase_tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
    "is_tax_inclusive": true,
    "sales_account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
    "sales_description": "Office desk sold to customers",
    "purchase_vendor_id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
    "purchase_account_id": "e35f42b4-a6e2-4664-96df-d2cf3f1a6f33",
    "purchase_description": "Office desk purchased from vendors"
  },
  "status": true,
  "message": "Successfully updated inventory"
}

Updates an inventory item.

Requires the can_modify_sales_inventory permission on the key owner’s role.

Keys: secret key only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active workspace.

Path parameters

idstringRequired

Request

This endpoint expects an object.

typestringRequired

namestringOptional

usagestringOptional

sales_account_idstringOptionalformat: "uuid"

purchase_account_idstringOptionalformat: "uuid"

sales_descriptionstringOptional

purchase_descriptionstringOptional

sales_tax_idstringOptionalformat: "uuid"

purchase_tax_idstringOptionalformat: "uuid"

purchase_vendor_idstringOptionalformat: "uuid"

tax_inclusivebooleanOptional

cost_priceslist of objectsOptional

selling_priceslist of objectsOptional

Response

dataobject

statusboolean

messagestring

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error