Files
api-specs/idn/beta/paths/segment-change-assignments.yaml
2022-09-02 10:59:29 -04:00

81 lines
2.7 KiB
YAML

post:
operationId: segmentChangeAssignments
tags:
- Segments
summary: Change Segment assignments.
description: >-
This API makes changes to the objects which are assigned to a Segment.
No more than 50 changes can be made in a single call. A 400 error will result if more changes than that are
specified.
Note that segmentation changes may take time to propagate through the system.
A token with ORG_ADMIN or API authority is required to call this API.
parameters:
- in: path
name: id
required: true
schema:
type: string
description: The ID of the Segment
example: ab5fc0cd-e021-4b76-96e6-4818df0d73d5
requestBody:
required: true
content:
application/json:
schema:
$ref: '../schemas/SegmentChangeAssignments.yaml'
responses:
'202':
description: Accepted for processing, indicates no errors detected.
$ref: '../../v3/responses/202.yaml'
'400':
description: Client Error - Returned if the request body is invalid.
content:
application/json:
schema:
$ref: '../../v3/schemas/ErrorResponseDto.yaml'
examples:
400.1 Bad Request Content:
description: Response for bad request content
value:
detailCode: 400.1 Bad Request Content
trackingId: 1ea1adcb84da4dcb890145e05745774e
messages:
- locale: en-US
localeOrigin: DEFAULT
text: The request was syntactically correct but its content is semantically invalid.
400.1.4 Entitlements limit violation:
description: Entitlements limit violation response
value:
detailCode: 400.1.4 Limit violation
trackingId: 77aa89ac6f0e422dbc588866abc22be9
messages:
- locale: en-US
localeOrigin: DEFAULT
text: You have reached the current limit of 20000 entitlements.
400.1.4 Segments limit violation:
description: Segments limit violation response
value:
detailCode: 400.1.4 Limit violation
trackingId: 77aa89ac6f0e422dbc588866abc22be9
messages:
- locale: en-US
localeOrigin: DEFAULT
text: You have reached the current limit of 100 segments for entitlement.
'401':
$ref: '../../v3/responses/401.yaml'
'403':
$ref: '../../v3/responses/403.yaml'
'429':
$ref: '../../v3/responses/429.yaml'
'500':
$ref: '../../v3/responses/500.yaml'