---
title: "Create shield information barrier"
method: POST
path: "/shield_information_barriers"
tags: ["Shield information barriers"]
---

# Create shield information barrier

`POST /shield_information_barriers`

Creates a shield information barrier to
separate individuals/groups within the same
firm and prevents confidential information passing between them.

## Request body

- object
  - `enterprise` EnterpriseBase, required — A representation of a enterprise, used when nested within another resource.
    - `id` string — The unique identifier for this enterprise.
    - `type` 'enterprise' — The value will always be `enterprise`.

## Response `201`

Returns a new shield information barrier object.

- ShieldInformationBarrier — A standard 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.
  - `enterprise` EnterpriseBase — A representation of a enterprise, used when nested within another resource.
    - `id` string — The unique identifier for this enterprise.
    - `type` 'enterprise' — The value will always be `enterprise`.
  - `status` 'draft' | 'pending' | 'disabled' | 'enabled' | 'invalid' — Status of the shield information barrier.
  - `created_at` string, date-time — ISO date time string when this shield information barrier object was created.
  - `created_by` UserBase — A mini representation of a user, used when nested within another resource.
    - `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 was updated.
  - `updated_by` UserBase — A mini representation of a user, used when nested within another resource.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.
  - `enabled_at` string, date-time — ISO date time string when this shield information barrier was enabled.
  - `enabled_by` object — The user that enabled this shield information barrier.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.

## Other responses

- `400` — Returns an error if the enterprise is missing from the request.
- `404` — Returns an error when an incorrect or null enterprise is present in the request body.
- `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)