---
title: "Bulk Insert Items"
method: POST
path: "/public/catalogs/{catalog_id}/items/bulk"
tags: ["Catalogs"]
---

# Bulk Insert Items

`POST /public/catalogs/{catalog_id}/items/bulk`

## Request

- Base URL: `https://catalogapi.rastro.ai/api`
- URL: `https://catalogapi.rastro.ai/api/public/catalogs/{catalog_id}/items/bulk`
- Auth: HTTP bearer

Bulk create catalog items.

Args:
    catalog_id: The catalog ID
    request: Bulk insert request with items

Returns:
    Summary of the bulk operation

## Path parameters

- `catalog_id` string, required

## Headers

- `X-Organization-Id` string, nullable

## Request body

- BulkInsertItemsRequest: Request to bulk upsert catalog items
  - `items` object[], required: List of item data to upsert
  - `source_info` object, nullable: Information about data source
  - `auto_evolve_schema` boolean, nullable: Accepted for compatibility. Public bulk writes currently allow schema evolution from submitted item data.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/rastro-ai/apis/rastro-public-api.md) - [All operations](https://skmtc.dev/rastro-ai/apis/rastro-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rastro-ai/apis/rastro-public-api/revisions/57c8ed4854bb?raw)