---
title: "Run Shortcut Batch"
method: POST
path: "/api/v1/shortcuts/{id}/run/batch"
tags: ["Shortcuts"]
---

# Run Shortcut Batch

`POST /api/v1/shortcuts/{id}/run/batch`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/shortcuts/{id}/run/batch`
- Auth: HTTP bearer

Starts one shortcut run per input row, grouped under a single `batch_id`. The shortcut must be published. Key each row by the field `reference` values from the shortcut's `input_schema` (see Get Shortcut); unknown keys are rejected with a 400 listing the valid references. Accepts up to 1000 rows per request. Runs execute asynchronously — poll List Shortcut Runs with the returned `batch_id` for status and results.

## Path parameters

- `id` string, required

## Request body

- object
  - `rows` object[], required: Input rows — one shortcut run is created per row. Each row is keyed by field `reference` values from the shortcut's `input_schema`.

## Response `201`

Default Response

- object
  - `status` integer
  - `message` string
  - `data` object
    - `batch_id` string: ID grouping every run created by this request — filter List Shortcut Runs by it
    - `run_count` integer: Number of runs created

## Other responses

- `400`: Invalid input fields
- `401`: Unauthorized — missing or invalid API key
- `403`: Forbidden. `code` says which permission refused: ROLE_FORBIDDEN (your role), INSUFFICIENT_SCOPE (the API key's scopes), WORKFLOW_FORBIDDEN (no access to the workflow), KEY_WORKFLOW_FORBIDDEN (the API key's workflow restriction). Also returned when the shortcut is unpublished.
- `404`: Shortcut not found
- `429`: Too Many Requests — rate limit exceeded. Check `Retry-After` header for seconds until the limit resets.

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)