curl --request PUT \
--url https://api.rootfi.dev/v4/ecommerce/items/{id} \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"data": [
{
"name": "<string>",
"description": "<string>",
"sku": "<string>",
"status": "active",
"created_at": "<string>",
"updated_at": "<string>",
"variants": [
{
"rootfi_id": 123,
"platform_id": "<string>",
"name": "<string>",
"sku": "<string>",
"price": 123,
"compare_at_price": 123,
"currency_id": "<string>",
"status": "active"
}
]
}
]
}
'{
"rootfi_id": 157,
"rootfi_created_at": "2024-01-22T05:07:31.465Z",
"rootfi_updated_at": "2024-01-22T05:07:31.465Z",
"rootfi_company_id": 1089,
"platform_id": "prod_789",
"name": "Wireless Headphones - Updated",
"description": "Premium wireless headphones",
"sku": "WH-2024-BLK",
"status": "active"
}Update an existing item in the e-commerce platform.
curl --request PUT \
--url https://api.rootfi.dev/v4/ecommerce/items/{id} \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"data": [
{
"name": "<string>",
"description": "<string>",
"sku": "<string>",
"status": "active",
"created_at": "<string>",
"updated_at": "<string>",
"variants": [
{
"rootfi_id": 123,
"platform_id": "<string>",
"name": "<string>",
"sku": "<string>",
"price": 123,
"compare_at_price": 123,
"currency_id": "<string>",
"status": "active"
}
]
}
]
}
'{
"rootfi_id": 157,
"rootfi_created_at": "2024-01-22T05:07:31.465Z",
"rootfi_updated_at": "2024-01-22T05:07:31.465Z",
"rootfi_company_id": 1089,
"platform_id": "prod_789",
"name": "Wireless Headphones - Updated",
"description": "Premium wireless headphones",
"sku": "WH-2024-BLK",
"status": "active"
}| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | The rootfi_id or platform_id of the item to update |
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | No | Product name |
| description | string | No | Product description |
| sku | string | No | Stock keeping unit (SKU) |
| price | number | No | Base price of the item |
| currency_id | string | No | ISO 4217 currency code |
| status | string | No | Item status (active, inactive, archived) |
| variants | array | No | Array of variant objects |
The rootfi_id or platform_id of the item
The data of the items endpoint
Show child attributes
Item updated successfully
V4 Item object (replaces Product) with embedded Variants
The unique ID we assign for that data's information
157
The date at which RootFi first synced this data
"2024-01-22T05:07:31.465Z"
The latest date at which RootFi updated this data
"2024-01-22T05:07:31.000Z"
The ID of the company in the accounting platform
1089
An unique custom RootFi ID made from platform's unique_id.
"123456"
The date at which the data was deleted in the accounting platform
The ID of the data in the accounting platform.
A JSON containing fields that you can directly get from the accounting platform.
The hash of the data
Display name of the product (e.g., "Wireless Headphones")
Detailed description of the product, including features and specifications
Stock Keeping Unit - unique identifier for inventory tracking
Current availability status of the item
active, archived, draft, unknown Original creation timestamp from the source platform (ISO 8601)
Last modification timestamp from the source platform (ISO 8601)
Collection of product variants with different attributes (size, color, etc.)
Show child attributes