The Box Shield Information Barrier Segment Restrictions API defines the restriction rules between information barrier segments, specifying which pairs of segments are prevented from collaborating with each other.
openapi: 3.1.0
info:
title: Box Shield Information Barrier Segment Restrictions API
description: Needs a description.
paths:
/shield_information_barrier_segment_restrictions/{shield_information_barrier_segment_restriction_id}:
get:
operationId: get_shield_information_barrier_segment_restrictions_id
summary: Box Get shield information barrier segment restriction by ID
tags:
- Shield Information Barrier Segment Restrictions
x-box-tag: shield_information_barrier_segment_restrictions
description: |-
Retrieves a shield information barrier segment
restriction based on provided ID.
parameters:
- name: shield_information_barrier_segment_restriction_id
description: The ID of the shield information barrier segment Restriction.
example: '4563'
in: path
required: true
schema:
type: string
responses:
'200':
description: |-
Returns the shield information barrier segment
restriction object.
content:
application/json:
schema:
$ref: >-
#/components/schemas/ShieldInformationBarrierSegmentRestriction
'404':
description: |-
Returns a `not_found` error if the
shield information barrier segment
restriction was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ClientError'
default:
description: An unexpected client error.
content:
application/json:
schema:
$ref: '#/components/schemas/ClientError'
delete:
operationId: delete_shield_information_barrier_segment_restrictions_id
summary: Box Delete shield information barrier segment restriction by ID
tags:
- Shield Information Barrier Segment Restrictions
x-box-tag: shield_information_barrier_segment_restrictions
description: |-
Delete shield information barrier segment restriction
based on provided ID.
parameters:
- name: shield_information_barrier_segment_restriction_id
description: The ID of the shield information barrier segment Restriction.
example: '4563'
in: path
required: true
schema:
type: string
responses:
'204':
description: Empty body in response
'404':
description: |-
Returns a `not_found` error if the
shield information barrier segment restriction was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ClientError'
default:
description: An unexpected client error.
content:
application/json:
schema:
$ref: '#/components/schemas/ClientError'
/shield_information_barrier_segment_restrictions:
get:
operationId: get_shield_information_barrier_segment_restrictions
summary: Box List shield information barrier segment restrictions
tags:
- Shield Information Barrier Segment Restrictions
x-box-tag: shield_information_barrier_segment_restrictions
description: |-
Lists shield information barrier segment restrictions
based on provided segment ID.
parameters:
- name: shield_information_barrier_segment_id
description: The ID of the shield information barrier segment.
example: '3423'
required: true
in: query
schema:
type: string
- name: marker
description: >-
Defines the position marker at which to begin returning results.
This is
used when paginating using marker-based pagination.
This requires `usemarker` to be set to `true`.
in: query
required: false
example: JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii
schema:
type: string
- name: limit
description: The maximum number of items to return per page.
in: query
required: false
example: 1000
schema:
type: integer
format: int64
maximum: 1000
responses:
'200':
description: |-
Returns a paginated list of
shield information barrier segment restriction objects.
content:
application/json:
schema:
$ref: >-
#/components/schemas/ShieldInformationBarrierSegmentRestrictions
default:
description: An unexpected client error.
content:
application/json:
schema:
$ref: '#/components/schemas/ClientError'
post:
operationId: post_shield_information_barrier_segment_restrictions
summary: Box Create shield information barrier segment restriction
tags:
- Shield Information Barrier Segment Restrictions
x-box-tag: shield_information_barrier_segment_restrictions
description: |-
Creates a shield information barrier
segment restriction object.
requestBody:
content:
application/json:
schema:
type: object
required:
- type
- shield_information_barrier_segment
- restricted_segment
properties:
type:
type: string
description: |-
The type of the shield barrier segment
restriction for this member.
example: shield_information_barrier_segment_restriction
enum:
- shield_information_barrier_segment_restriction
shield_information_barrier:
$ref: '#/components/schemas/ShieldInformationBarrier--Base'
shield_information_barrier_segment:
type: object
properties:
id:
type: string
example: '1910967'
description: |-
The ID reference of the requesting
shield information barrier segment.
type:
type: string
description: The type of the shield barrier segment for this member.
example: shield_information_barrier_segment
enum:
- shield_information_barrier_segment
description: |-
The `type` and `id` of the requested
shield information barrier segment.
restricted_segment:
type: object
properties:
id:
type: string
example: '1910967'
description: |-
The ID reference of the restricted
shield information barrier segment.
type:
type: string
example: shield_information_barrier_segment
description: |-
The type of the restricted shield
information barrier segment.
enum:
- shield_information_barrier_segment
description: |-
The `type` and `id` of the restricted
shield information barrier segment.
responses:
'201':
description: |-
Returns the newly created Shield
Information Barrier Segment Restriction object.
content:
application/json:
schema:
$ref: >-
#/components/schemas/ShieldInformationBarrierSegmentRestriction
'404':
description: |-
Returns a `not_found` error if the
shield information barrier or segment was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ClientError'
default:
description: An unexpected client error.
content:
application/json:
schema:
$ref: '#/components/schemas/ClientError'
components:
schemas:
ShieldInformationBarrierSegmentRestriction:
title: Shield information barrier segment restriction
type: object
x-box-resource-id: shield_information_barrier_segment_restriction
x-box-tag: shield_information_barrier_segment_restrictions
x-box-variants:
- base
- mini
- standard
x-box-variant: standard
description: |-
A standard representation of a
segment restriction of a shield information barrier
object
required:
- shield_information_barrier_segment
- restricted_segment
allOf:
- $ref: >-
#/components/schemas/ShieldInformationBarrierSegmentRestriction--Mini
- properties:
shield_information_barrier:
$ref: '#/components/schemas/ShieldInformationBarrier--Base'
created_at:
type: string
format: date-time
example: '2020-06-26T18:44:45.869Z'
description: |-
ISO date time string when this
shield information barrier
Segment Restriction object was created.
created_by:
allOf:
- $ref: '#/components/schemas/User--Base'
- description: >-
The user who created this shield information barrier segment
Restriction.
updated_at:
type: string
format: date-time
example: '2020-07-26T18:44:45.869Z'
description: |-
ISO date time string when this
shield information barrier segment
Restriction was updated.
updated_by:
allOf:
- $ref: '#/components/schemas/User--Base'
- description: >-
The user that updated this shield information barrier
segment Restriction.
ClientError:
title: Client error
type: object
x-box-resource-id: client_error
description: A generic error
properties:
type:
description: error
example: error
type: string
enum:
- error
nullable: false
status:
description: The HTTP status of the response.
example: 400
type: integer
format: int32
nullable: false
code:
description: A Box-specific error code
example: item_name_invalid
type: string
enum:
- created
- accepted
- no_content
- redirect
- not_modified
- bad_request
- unauthorized
- forbidden
- not_found
- method_not_allowed
- conflict
- precondition_failed
- too_many_requests
- internal_server_error
- unavailable
- item_name_invalid
- insufficient_scope
message:
description: A short message describing the error.
example: Method Not Allowed
type: string
nullable: false
context_info:
description: |-
A free-form object that contains additional context
about the error. The possible fields are defined on
a per-endpoint basis. `message` is only one example.
type: object
nullable: true
properties:
message:
type: string
description: More details on the error.
example: Something went wrong.
help_url:
description: A URL that links to more information about why this error occurred.
example: >-
https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/
type: string
nullable: false
request_id:
description: |-
A unique identifier for this response, which can be used
when contacting Box support.
type: string
example: abcdef123456
nullable: false
ShieldInformationBarrierSegmentRestrictions:
title: List of Shield Information Barrier Segment Restrictions
type: object
x-box-resource-id: shield_information_barrier_segment_restrictions
x-box-tag: shield_information_barrier_segment_restrictions
description: List of shield information barrier segment restriction objects
allOf:
- type: object
description: |-
The part of an API response that describes marker
based pagination
properties:
limit:
description: >-
The limit that was used for these entries. This will be the same
as the
`limit` query parameter unless that value exceeded the maximum
value
allowed. The maximum value varies by API.
example: 1000
type: integer
format: int64
next_marker:
description: The marker for the start of the next page of results.
example: JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii
type: string
nullable: true
- properties:
entries:
type: array
description: |-
A list of shield information barrier
segment restriction objects
items:
$ref: >-
#/components/schemas/ShieldInformationBarrierSegmentRestriction
tags:
- name: Shield Information Barrier Segment Restrictions