openapi: 3.1.0 info: title: Box Shield Information Barrier Segment Members API description: Needs a description. paths: /shield_information_barrier_segment_members/{shield_information_barrier_segment_member_id}: get: operationId: get_shield_information_barrier_segment_members_id summary: Box Get shield information barrier segment member by ID tags: - Shield Information Barrier Segment Members x-box-tag: shield_information_barrier_segment_members description: |- Retrieves a shield information barrier segment member by its ID. parameters: - name: shield_information_barrier_segment_member_id description: The ID of the shield information barrier segment Member. example: '7815' in: path required: true schema: type: string responses: '200': description: Returns the shield information barrier segment member object. content: application/json: schema: $ref: '#/components/schemas/ShieldInformationBarrierSegmentMember' '404': description: |- Returns a `not_found` error if the shield information barrier segment member 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_members_id summary: Box Delete shield information barrier segment member by ID tags: - Shield Information Barrier Segment Members x-box-tag: shield_information_barrier_segment_members description: |- Deletes a shield information barrier segment member based on provided ID. parameters: - name: shield_information_barrier_segment_member_id description: The ID of the shield information barrier segment Member. example: '7815' in: path required: true schema: type: string responses: '204': description: |- Returns an empty response if the segment member was deleted successfully. '404': description: |- Returns a `not_found` error if the shield information barrier segment member 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_members: get: operationId: get_shield_information_barrier_segment_members summary: Box List shield information barrier segment members tags: - Shield Information Barrier Segment Members x-box-tag: shield_information_barrier_segment_members description: |- Lists shield information barrier segment members based on provided segment IDs. 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 member objects. content: application/json: schema: $ref: '#/components/schemas/ShieldInformationBarrierSegmentMembers' default: description: An unexpected client error. content: application/json: schema: $ref: '#/components/schemas/ClientError' post: operationId: post_shield_information_barrier_segment_members summary: Box Create shield information barrier segment member tags: - Shield Information Barrier Segment Members x-box-tag: shield_information_barrier_segment_members description: Creates a new shield information barrier segment member. requestBody: content: application/json: schema: type: object required: - shield_information_barrier_segment - user properties: type: description: '-| A type of the shield barrier segment member.' type: string example: shield_information_barrier_segment_member enum: - shield_information_barrier_segment_member shield_information_barrier: $ref: '#/components/schemas/ShieldInformationBarrier--Base' shield_information_barrier_segment: type: object properties: id: type: string example: '432554' 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. user: allOf: - $ref: '#/components/schemas/User--Base' description: User to which restriction will be applied. responses: '201': description: Returns a new shield information barrier segment member object. content: application/json: schema: $ref: '#/components/schemas/ShieldInformationBarrierSegmentMember' '404': description: |- Returns an 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: ShieldInformationBarrierSegmentMember: title: Shield information barrier segment member type: object x-box-resource-id: shield_information_barrier_segment_member x-box-tag: shield_information_barrier_segment_members x-box-variants: - base - mini - standard x-box-variant: standard description: |- A standard representation of a shield information barrier segment member object allOf: - $ref: '#/components/schemas/ShieldInformationBarrierSegmentMember--Mini' - properties: shield_information_barrier: $ref: '#/components/schemas/ShieldInformationBarrier--Base' shield_information_barrier_segment: type: object properties: id: type: string example: '432554' description: |- The ID reference of the requesting shield information barrier segment. type: type: string example: shield_information_barrier_segment description: The type of the shield information barrier segment enum: - shield_information_barrier_segment description: |- The `type` and `id` of the requested shield information barrier segment. user: allOf: - $ref: '#/components/schemas/User--Base' - description: >- The `type` and `id` of the requested shield information barrier segment member. created_at: type: string format: date-time example: '2020-06-26T18:44:45.869Z' description: |- ISO date time string when this shield information barrier object was created. created_by: allOf: - $ref: '#/components/schemas/User--Base' - description: >- The user who created this shield information barrier segment member. 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 Member was updated. updated_by: allOf: - $ref: '#/components/schemas/User--Base' - description: >- The user that updated this shield information barrier segment Member. 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 ShieldInformationBarrierSegmentMembers: title: List of Shield Information Barrier Segment Members type: object x-box-resource-id: shield_information_barrier_segment_members x-box-tag: shield_information_barrier_segment_members description: List of Shield Information Barrier Member 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 members items: $ref: '#/components/schemas/ShieldInformationBarrierSegmentMember' tags: - name: Shield Information Barrier Segment Members