---
title: "Create shield information barrier segment"
method: POST
path: "/shield_information_barrier_segments"
tags: ["Shield information barrier segments"]
---

# Create shield information barrier segment

`POST /shield_information_barrier_segments`

Creates a shield information barrier segment.

## Request body

- object
  - `shield_information_barrier` ShieldInformationBarrierBase, required — A base representation of a shield information barrier object.
    - `id` string — The unique identifier for the shield information barrier.
    - `type` 'shield_information_barrier' — The type of the shield information barrier.
  - `name` string, required — Name of the shield information barrier segment.
  - `description` string — Description of the shield information barrier segment.

## Response `201`

Returns a new shield information barrier segment object.

- ShieldInformationBarrierSegment — A shield information barrier segment object.
  - `id` string — The unique identifier for the shield information barrier segment.
  - `type` 'shield_information_barrier_segment' — The type of the shield information barrier segment.
  - `shield_information_barrier` ShieldInformationBarrierBase — A base representation of a shield information barrier object.
    - `id` string — The unique identifier for the shield information barrier.
    - `type` 'shield_information_barrier' — The type of the shield information barrier.
  - `name` string — Name of the shield information barrier segment.
  - `description` string — Description of the shield information barrier segment.
  - `created_at` string, date-time — ISO date time string when this shield information barrier object was created.
  - `created_by` object — The user who created this shield information barrier segment.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.
  - `updated_at` string, date-time — ISO date time string when this shield information barrier segment was updated.
  - `updated_by` object — The user that updated this shield information barrier segment.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.

## Other responses

- `404` — Returns an error if the shield information barrier was not found.
- `409` — Returns an error if there exists an shield information barrier segment with same name.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)