---
title: "Apply an ordered list of schematic actions atomically"
method: POST
path: "/api/v0/components/{component_id}/schematic/batch"
tags: ["Components"]
---

# Apply an ordered list of schematic actions atomically

`POST /api/v0/components/{component_id}/schematic/batch`

## Path parameters

- `component_id` string, required

## Query parameters

- `vc_id` string, required — Public ID of the target visual component

## Request body

- BatchRequest
  - `actions` BatchAction[], required
    - `kind` 'create' | 'patch' | 'delete', required
    - `entity` 'node' | 'annotation' | 'vertex' | 'segment' | 'association' | 'arrow' | 'flow_direction' | 'logical_line' | 'visual_reference', required
    - `id` string, nullable
    - `body` object, nullable

## Response `200`

Successful Response

- BatchResponse — Atomic result. ``status="ok"`` → all actions applied + saved. The FE clears its action stack. ``status="error"`` → an action failed; nothing was saved. The FE keeps its action stack so the user can retry / investigate.
  - `status` 'ok' | 'error', required
  - `completed` integer, required
  - `error` BatchError
    - `action_index` integer, required
    - `description` string, required
    - `message` string, required
  - `skipped` BatchError[]
    - `action_index` integer, required
    - `description` string, required
    - `message` string, required

## Other responses

- `422` — Validation Error

---

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