---
title: "Submit a list of batches to the Scabbard service"
method: POST
path: "/scabbard/{circuit}/{service_id}/batches"
tags: ["Scabbard"]
---

# Submit a list of batches to the Scabbard service

`POST /scabbard/{circuit}/{service_id}/batches`

This endpoint can be used to submit batches to a Scabbard service. The
body of the request must be a list of valid Sabre batches. If the
batches are submitted successfully, the response will contain a link for
checking the status of the submitted batches.

This endpoint requires the permission "scabbard.write".

## Path parameters

- `circuit` string, required
- `service_id` string, required

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Response `202`

Batch was submitted successfully

- Link
  - `link` string — Link to get status of batches that were submitted

## Other responses

- `400` — Request was malformed
- `401` — The client is unauthorized
- `404` — The scabbard service with the given circuit and service id was not found
- `429` — Too many requests have been made to process batches
- `500` — An internal server error occurred

---

[API](https://skmtc.dev/cargill/apis/splinterd-api.md) · [All operations](https://skmtc.dev/cargill/apis/splinterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cargill/splinterd-api/revisions/38a272c24bd9/schema)