---
search:
  tags:
    - Inventory
    - POST
seo:
  description: >-
    Up to 200 entries; requestId and inventoryItemId must each be… Reference for
    the POST /inventory/commitments/batch endpoint in the Toreca Cloud Partner
    API.
sidebar:
  label: Commit units in a batch
  badge: POST
title: Commit units in a batch
type: openapi-operation
---
Up to 200 entries; requestId and inventoryItemId must each be unique. All succeed or none do. Creation returns 201; replaying the same requestId and content returns 200. Reusing requestId for different content fails with idempotency_conflict. In addition to inventory:read, this needs its operation scope and the approving member’s inventory.write permission.

`POST /inventory/commitments/batch`

**Request body** (`application/json`, required)

- `commitments` (object[], required)

Request body example:

```json
{
  "commitments": [
    {
      "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6",
      "inventoryItemId": "ef1bc09e-447a-46aa-a9d9-d86e3d490831",
      "purpose": "oripa",
      "label": "string",
      "externalRef": "string"
    }
  ]
}
```

**Responses**

- `200` — Success
- `201` — Created
- `400` — \`invalid\_request\`: a parameter is invalid.
- `401` — \`invalid\_token\`: the token is missing, expired, or for another resource.
- `403` — One of \`insufficient\_scope\`, \`connection\_revoked\`, \`client\_disabled\` or \`forbidden\`.
- `409` — Conflict, reused requestId or receipt not confirmed
- `422` — The state, target or value refuses the operation. Inspect error and affected IDs.

Response example, 200:

```json
{
  "commitments": [
    {
      "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6",
      "created": true,
      "commitment": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "inventoryItemId": "ef1bc09e-447a-46aa-a9d9-d86e3d490831",
        "assetNumber": "string",
        "purpose": "oripa",
        "label": "string",
        "externalRef": "string",
        "status": "on_sale",
        "allocatedAt": "2019-08-24T14:15:22Z",
        "allocationRef": "string",
        "shipmentId": "47efd5a2-af91-4417-950a-7f546cd1b5cf",
        "closedAt": "2019-08-24T14:15:22Z"
      }
    }
  ]
}
```
