curl --request POST \
--url https://api.poelis.com/v1/public/items/bulk \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"product_id": "<string>",
"name": "<string>",
"readable_id": "<string>",
"description": "<string>",
"part_number": "<string>",
"parent_item_id": "<string>"
}
]
}
'import requests
url = "https://api.poelis.com/v1/public/items/bulk"
payload = { "items": [
{
"product_id": "<string>",
"name": "<string>",
"readable_id": "<string>",
"description": "<string>",
"part_number": "<string>",
"parent_item_id": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
product_id: '<string>',
name: '<string>',
readable_id: '<string>',
description: '<string>',
part_number: '<string>',
parent_item_id: '<string>'
}
]
})
};
fetch('https://api.poelis.com/v1/public/items/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"count": 1,
"items": [
{
"createdBy": {
"id": "auth0|550e8400-e29b-41d4-a716-446655440000",
"imageUrl": "https://example.com/avatar.png",
"userName": "Jane Doe"
},
"deleted": false,
"id": "770e8400-e29b-41d4-a716-446655440000",
"name": "Compressor Stage 1",
"part_number": "CS1-001",
"product_id": "660e8400-e29b-41d4-a716-446655440000",
"readable_id": "compressor-stage-1"
}
]
}{
"error": "unauthorized",
"message": "Invalid or missing API key"
}{
"error": "forbidden",
"message": "Access denied"
}{
"error": "not_found",
"message": "Not found"
}{
"error": "validation_error",
"message": "Invalid data format",
"details": {
"errors": [
{
"loc": [
"body",
"field_name"
],
"msg": "field required",
"type": "value_error.missing"
}
]
}
}{
"error": "rate_limit_exceeded",
"message": "Too many requests"
}Bulk create items
Create multiple items in a product in a single all-or-nothing request.
Overview
Accepts 1–50 items. If any row fails validation or persistence, the entire batch
is rolled back and no items are created. Error responses include details.index
(0-based) identifying the failing row.
Nested items
parent_item_id may point at an item that already exists in the same product.
A parent and its child cannot be created in the same request: new items do not
receive IDs until the batch commits, so in-batch parent references fail with
invalid_parent.
Part numbers
Same rules as single-item create: 409 for duplicate part_number within the
organization, 422 when the value does not match the product’s configured format.
curl --request POST \
--url https://api.poelis.com/v1/public/items/bulk \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"product_id": "<string>",
"name": "<string>",
"readable_id": "<string>",
"description": "<string>",
"part_number": "<string>",
"parent_item_id": "<string>"
}
]
}
'import requests
url = "https://api.poelis.com/v1/public/items/bulk"
payload = { "items": [
{
"product_id": "<string>",
"name": "<string>",
"readable_id": "<string>",
"description": "<string>",
"part_number": "<string>",
"parent_item_id": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
product_id: '<string>',
name: '<string>',
readable_id: '<string>',
description: '<string>',
part_number: '<string>',
parent_item_id: '<string>'
}
]
})
};
fetch('https://api.poelis.com/v1/public/items/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"count": 1,
"items": [
{
"createdBy": {
"id": "auth0|550e8400-e29b-41d4-a716-446655440000",
"imageUrl": "https://example.com/avatar.png",
"userName": "Jane Doe"
},
"deleted": false,
"id": "770e8400-e29b-41d4-a716-446655440000",
"name": "Compressor Stage 1",
"part_number": "CS1-001",
"product_id": "660e8400-e29b-41d4-a716-446655440000",
"readable_id": "compressor-stage-1"
}
]
}{
"error": "unauthorized",
"message": "Invalid or missing API key"
}{
"error": "forbidden",
"message": "Access denied"
}{
"error": "not_found",
"message": "Not found"
}{
"error": "validation_error",
"message": "Invalid data format",
"details": {
"errors": [
{
"loc": [
"body",
"field_name"
],
"msg": "field required",
"type": "value_error.missing"
}
]
}
}{
"error": "rate_limit_exceeded",
"message": "Too many requests"
}Authorizations
Enter your API key. Example: Bearer poelis_api_...
Body
Request to create multiple items in one all-or-nothing transaction.
Items to create (1–50). The request is all-or-nothing: if any row fails, none are created. parent_item_id must refer to an item that already exists; a parent and child cannot be created in the same request.
1 - 50 elementsShow child attributes
Show child attributes