---
title: "Batch Update Positions"
method: POST
path: "/workspaces/{workspace_id}/actions/batch-positions"
tags: ["actions"]
---

# Batch Update Positions

`POST /workspaces/{workspace_id}/actions/batch-positions`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/workspaces/{workspace_id}/actions/batch-positions`
- Auth: one of:
  - API key in cookie `fastapiusersauth`
  - HTTP bearer

Batch update action and trigger positions.

This endpoint updates all positions in a single transaction for atomicity,
preventing race conditions from concurrent position updates.

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `workflow_id` union, required
  - string
  - string

## Request body

- BatchPositionUpdate: Batch update for action and trigger positions.
  - `actions` ActionPositionUpdate[]
    - `action_id` string, uuid, required
    - `position` Position, required
      - `x` number
      - `y` number
  - `trigger_position` Position
    - `x` number
    - `y` number

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

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