Skip to main content

Update a Permission

Update a permission given their permissionId.

caution

This endpoint has been deprecated and will be phased out at the end of 2023. Please update any existing usages of it to use the Update Object endpoint instead.

Endpoint

PUT /v1/permissions/:permissionId

Parameters

ParameterDescriptionTypeRequired
permissionIdThe id of the permission to update. Note that id cannot be changed.URL paramyes
nameAn optional, display-friendly name for the permission.JSON bodyno
descriptionAn optional description of the permission. A useful description might include a summary of the functionality the permission grants.JSON bodyno

Note: Optional fields that are omitted will clear existing values.

Request

curl "https://api.warrant.dev/v1/permissions/view-contact-info" \
-X PUT \
-H "Authorization: ApiKey YOUR_KEY" \
--data-raw \
'{ "name": "View Contact Info", description: "Grant user access to view customer contact info" }'

Response

{
"permissionId": "view-contact-info",
"name": "View Contact Info",
"description": "Grant user access to view customer contact info"
}