---
title: "Batch process draft components"
method: POST
path: "/stakeholder-comms/cloudId/{cloudId}/api/components/batch_process"
tags: ["Status Page"]
---

# Batch process draft components

`POST /stakeholder-comms/cloudId/{cloudId}/api/components/batch_process`

Create, update, or delete draft components for a Status page in a single batch operation.

## Request body

- StakeholderCommsBatchComponentProcessRequest — Batch process components for a Stakeholder Comms page.
  - `pageId` string — Identifier of the page to process components for.
  - `createUpdateComponents` StakeholderCommsNestedDraftComponentInput[] — Components to create or update.
    - `id` string — Identifier of the component. Omit for create operations.
    - `pageId` string, required — Identifier of the page this component belongs to.
    - `name` string — Name of the component.
    - `description` string — Description of the component.
    - `status` 'OPERATIONAL' | 'DEGRADED_PERFORMANCE' | 'PARTIAL_OUTAGE' | 'MAJOR_OUTAGE' | 'UNDER_MAINTENANCE' — Current status of the component.
    - `serviceId` string — Identifier of the associated service.
    - `type` 'COMPONENT' | 'GROUP_COMPONENT', required — Type of the component.
    - `position` integer — Position of the component in the display order.
    - `components` StakeholderCommsNestedDraftComponentInput[] — Nested sub-components within this component.
  - `deleteComponents` string[] — IDs of components to delete.

## Response `200`

Returned if the batch operation is successfully processed.

- StakeholderCommsNestedComponent[]
  - `id` string — Unique identifier of the component.
  - `name` string — Name of the component.
  - `pageId` string — Identifier of the page this component belongs to.
  - `serviceId` string — Identifier of the linked service.
  - `status` 'OPERATIONAL' | 'DEGRADED_PERFORMANCE' | 'PARTIAL_OUTAGE' | 'MAJOR_OUTAGE' | 'UNDER_MAINTENANCE' — Current status of the component.
  - `type` 'COMPONENT' | 'GROUP_COMPONENT' — Type of the component.
  - `description` string — Description of the component.
  - `position` integer — Display position of the component.
  - `components` StakeholderCommsNestedComponent[] — Nested sub-components (for group components).

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the user does not have permission to modify components.
- `500` — Returned if an internal server error occurs.

---

[API](https://skmtc.net/atlassian/apis/jsm-operations-api.md) · [All operations](https://skmtc.net/atlassian/apis/jsm-operations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jsm-operations-api/versions/ed65f017bcb8/schema)