---
title: "Create Upload Batch"
method: POST
path: "/v1/matters/{matter_id}/memory/upload-batches"
tags: ["memory-uploads"]
---

# Create Upload Batch

`POST /v1/matters/{matter_id}/memory/upload-batches`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/memory/upload-batches`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateUploadBatch
  - `destination_parent_id` string, uuid, nullable
  - `label` string, nullable
  - `purpose` 'memory' | 'voidables'
  - `items` UploadManifestItem[], required
    - `relative_path` string, required
    - `byte_size` integer, required
    - `mime_type` string, nullable
    - `replace_item_id` string, uuid, nullable
    - `expected_current_version_id` string, uuid, nullable

## Response `201`

Successful Response

- UploadBatchCreated
  - `batch_id` string, uuid, required
  - `version` integer, required
  - `pipeline_protocol_version` 1 | 2, required
  - `expires_at` string, date-time, required
  - `targets` AppModulesMemoryUploadUploadContractsUploadTargetResponse[], required
    - `item_id` string, uuid, required
    - `relative_path` string, nullable, required
    - `upload_url` string, required
    - `method` string, required
    - `headers` object, required
    - `form_fields` object, required
    - `expires_at` string, date-time, required
  - `next_target_offset` integer, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)