Skip to main content
PUT
/
v2
/
app-resource-roles
/
{id}
Update App Resource Role
curl --request PUT \
  --url https://public.api.serval.com/v2/app-resource-roles/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "requestsEnabled": true,
  "accessPolicyId": "<string>",
  "provisioningMethod": {
    "builtinWorkflow": {}
  },
  "externalId": "<string>",
  "externalData": "<string>",
  "requireFormConfirmation": true
}
'
{
  "data": {
    "id": "<string>",
    "resourceId": "<string>",
    "name": "<string>",
    "description": "<string>",
    "requestsEnabled": true,
    "accessPolicyId": "<string>",
    "provisioningMethod": {
      "builtinWorkflow": {}
    },
    "externalId": "<string>",
    "externalData": "<string>",
    "requireFormConfirmation": true
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The ID of the role.

Body

application/json
​
name
string | null

The name of the role. Omit to leave unchanged.

​
description
string | null

A description of the role. Omit to leave unchanged.

​
requestsEnabled
boolean | null

Whether requests are enabled for the role. Omit to leave unchanged.

​
accessPolicyId
string | null

The default access policy for the role (optional).

​
provisioningMethod
Builtin Workflow · object

Provisioning configuration. Exactly one method should be set.

​
externalId
string | null

The external ID of the role in the external system (optional).

​
externalData
string | null

Data from the external system as a JSON string (optional).

​
requireFormConfirmation
boolean | null

Response

Success

​
data
data · object

The updated role.