Batch Update App Resource Entitlements
Update multiple app resource entitlements in a single transactional request. Either all updates succeed or all fail.
curl --request PUT \
--url https://public.api.serval.com/v2/app-resource-entitlements/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"entitlements": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"requestsEnabled": true,
"accessPolicyId": "<string>",
"provisioningMethod": {
"builtinWorkflow": {},
"customWorkflow": {
"provisionWorkflowId": "<string>",
"deprovisionWorkflowId": "<string>"
},
"linkedEntitlements": {
"linkedEntitlementIds": [
"<string>"
]
},
"manual": {
"assignees": [
{
"assigneeId": "<string>",
"assigneeType": "MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED"
}
]
}
}
}
]
}
'{
"data": [
{
"id": "<string>",
"resourceId": "<string>",
"name": "<string>",
"description": "<string>",
"requestsEnabled": true,
"accessPolicyId": "<string>",
"provisioningMethod": {
"builtinWorkflow": {},
"customWorkflow": {
"provisionWorkflowId": "<string>",
"deprovisionWorkflowId": "<string>"
},
"linkedEntitlements": {
"linkedEntitlementIds": [
"<string>"
]
},
"manual": {
"assignees": [
{
"assigneeId": "<string>",
"assigneeType": "MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED"
}
]
}
}
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The entitlements to update.
Show child attributes
Show child attributes
The ID of the entitlement to update.
The name of the entitlement.
A description of the entitlement.
Whether requests are enabled for the entitlement.
The default access policy for the entitlement (optional).
Preferred provisioning configuration. Exactly one method should be set.
Show child attributes
Show child attributes
Option: builtin_workflow
Option: manual
Show child attributes
Show child attributes
Users and groups that should be assigned/notified for manual provisioning.
Show child attributes
Show child attributes
The ID of the user or group.
The type of assignee.
MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED, MANUAL_PROVISIONING_ASSIGNEE_TYPE_USER, MANUAL_PROVISIONING_ASSIGNEE_TYPE_GROUP Response
Success
The updated entitlements.
Show child attributes
Show child attributes
The ID of the entitlement.
The ID of the resource that the entitlement belongs to.
The name of the entitlement.
A description of the entitlement.
Whether requests are enabled for the entitlement.
The default access policy for the entitlement.
Provisioning configuration. Exactly one method should be set.
Show child attributes
Show child attributes
Option: builtin_workflow
Option: manual
Show child attributes
Show child attributes
Users and groups that should be assigned/notified for manual provisioning.
Show child attributes
Show child attributes
The ID of the user or group.
The type of assignee.
MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED, MANUAL_PROVISIONING_ASSIGNEE_TYPE_USER, MANUAL_PROVISIONING_ASSIGNEE_TYPE_GROUP Was this page helpful?
curl --request PUT \
--url https://public.api.serval.com/v2/app-resource-entitlements/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"entitlements": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"requestsEnabled": true,
"accessPolicyId": "<string>",
"provisioningMethod": {
"builtinWorkflow": {},
"customWorkflow": {
"provisionWorkflowId": "<string>",
"deprovisionWorkflowId": "<string>"
},
"linkedEntitlements": {
"linkedEntitlementIds": [
"<string>"
]
},
"manual": {
"assignees": [
{
"assigneeId": "<string>",
"assigneeType": "MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED"
}
]
}
}
}
]
}
'{
"data": [
{
"id": "<string>",
"resourceId": "<string>",
"name": "<string>",
"description": "<string>",
"requestsEnabled": true,
"accessPolicyId": "<string>",
"provisioningMethod": {
"builtinWorkflow": {},
"customWorkflow": {
"provisionWorkflowId": "<string>",
"deprovisionWorkflowId": "<string>"
},
"linkedEntitlements": {
"linkedEntitlementIds": [
"<string>"
]
},
"manual": {
"assignees": [
{
"assigneeId": "<string>",
"assigneeType": "MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED"
}
]
}
}
}
]
}