---
title: "Create a new batch job"
method: POST
path: "/v1/batch-jobs"
tags: ["Batch Processing"]
---

# Create a new batch job

`POST /v1/batch-jobs`

Creates a new batch job that can process multiple content items in bulk. Returns a presigned URL for uploading the input file. The job will automatically start processing once the input file is uploaded.

## Request body

- V1CreateBatchJobRequest
  - `name` string
  - `policyId` string
  - `webhookUrl` string — The webhook URL to call when the batch job is complete. Optional.

## Response `200`

A successful response.

- V1CreateBatchJobResponse
  - `batchJobId` string
  - `name` string
  - `error` V1BatchJobError
    - `errorCode` 'BATCH_JOB_ERROR_UNSPECIFIED' | 'BATCH_JOB_ERROR_INVALID_INPUT_FILE' | 'BATCH_JOB_ERROR_INVALID_POLICY' | 'BATCH_JOB_ERROR_INVALID_POLICY_VERSION' | 'BATCH_JOB_ERROR_INVALID_PRIORITY'
    - `errorMessage` string
  - `inputFileUploadUrl` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `499` — Precheck Failures (Canceled)
- `default` — An unexpected error response.

---

[API](https://skmtc.net/clavata/apis/clavata-public-api-v1.md) · [All operations](https://skmtc.net/clavata/apis/clavata-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clavata/clavata-public-api-v1/revisions/7d66607e1ab6/schema)