# API Specification for Kevel

## Request Parameters

### catalogId
- **Type:** number  
- **Required:** Yes  
- **Constraints:** ≥ 100

### item
- **Type:** string  
- **Enum values:**  
  - `product`  
  - `brand`  
  - `category`  
  - `merchant`  
- **Required:** Yes  
- **Description:** Permitted item types.

## Items
- **Type:** array of objects  
- **Required:** Yes  
- **Constraints:** Length between 1 and 1000  
- **Description:** The items to be processed in the batch.

### Items*
- **Type:** object  
- **Description:** Catalog item data.

## Response

### Success Response
- **Status Code:** 200  
- **Message:** "Items upsert request successfully submitted to Kevel."

### Error Response
- **Status Code:** 400  
- **Message:** "Bad request with errors."

## Example curl Command
```bash
curl --request POST \
     --url https://api.kevel.co/v1/catalog/catalogId/product/batch/upsert \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"Items":[]}'
```

---  
Updated 9 months ago
