Remove Users & Groups from Roles on a Single Document

Note

If you need to remove users and groups from roles on more than one document or binder, it is best practice to use the bulk API.

Remove users and groups from roles on a single document or binder.

DELETE/api/{version}/objects/documents/{doc_id}/roles/{role_name_and_user_or_group}/{id}

Headers

Section link for Headers

Name	Description
Accept	application/json (default) or application/xml

URI Path Parameters

Section link for URI Path Parameters

Request

Section link for Request

Copy to clipboard

curl -X DELETE -H "Authorization: {SESSION_ID}" \
https://myvault.veevavault.com/api/v22.3/objects/documents/1234/roles/consumer__v.user/19376

Response

Section link for Response

Copy to clipboard

{
  "responseStatus": "SUCCESS",
  "responseMessage": "User/group deleted from document role",
  "updatedRoles": {
    "consumer__v": {
      "users": [
        19376
      ]
    }
  }
}