Skip to main content
POST
/
items
/
bulk
curl --request POST \
  --url https://api.retrac.co/items/bulk?workspaceId={WORKSPACE_ID} \
  --header 'Authorization: Bearer {YOUR_TOKEN}' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "sku": "FIRSTITEM",
      "description": "First item description",
      "quantity": 1,
      "cost": 1,
    },
    {
      "sku": "SECONDITEM",
      "description": "Second item description",
      "quantity": 2,
      "cost": 2,
    }
    ...
  ]'

[
  {
    "id": "<string>",
    "sku": "<string>",
    "description": "<string>",
    "supplier": "<string>",
    "cost": 123,
    "tagId": "<string>",
    "tags": [
      {
        "id": "<string>",
        "name": "<string>",
        "color": "red"
      }
    ],
    "userId": "<string>",
    "workspaceId": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "projectId": "<string>"
  }
]
curl --request POST \
  --url https://api.retrac.co/items/bulk?workspaceId={WORKSPACE_ID} \
  --header 'Authorization: Bearer {YOUR_TOKEN}' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "sku": "FIRSTITEM",
      "description": "First item description",
      "quantity": 1,
      "cost": 1,
    },
    {
      "sku": "SECONDITEM",
      "description": "Second item description",
      "quantity": 2,
      "cost": 2,
    }
    ...
  ]'

Authorizations

​
Authorization
string
header
required

Default authentication mechanism

Query Parameters

​
workspaceId
string
required

The ID of the workspace.

Example:

"ws_cluuwcv0r..."

​
projectSlug
string
deprecated

The slug of the project. This field is deprecated – use workspaceId instead.

Body

application/json
​
sku
string
required

The SKU of the item.

Example:

"FITEM"

​
description
string
required

The item description.

​
cost
number
required

The cost of the item.

​
supplier
string | null

The supplier of the item.

​
tagId
string | null
deprecated

[DEPRECATED] (use tagIds instead): The unique ID of the tag assigned to the short item.

​
tagIds

The unique IDs of the tags assigned to the short item.

​
tagNames

The unique name of the tags assigned to the item (case insensitive).

Response

The created items

​
id
string
required

The unique ID of the short item.

​
sku
string
required

The SKU of the item.

​
description
string
required

The item description.

​
supplier
string | null
required

The supplier of the item.

​
cost
number
required

The item cost.

​
tagId
string | null
required
deprecated

[DEPRECATED] (use tags instead): The unique ID of the tag assigned to the short item.

​
tags
Tag · object[] | null
required

The tags assigned to the short item.

​
userId
string
required

The user ID of the creator of the short item.

​
workspaceId
string
required

The workspace ID of the short item.

​
createdAt
string
required

The date and time when the short item was created.

​
updatedAt
string
required

The date and time when the short item was last updated.

​
projectId
string
required
deprecated

[DEPRECATED] (use workspaceId instead): The project ID of the short item.