**Source URL:** https://general.veevavault.dev/commercial/vault-api/api-reference/26.1/document-binder-roles/document-roles/assign-users-groups-to-roles-on-a-single-document.md

# Assign Users & Groups to Roles on a Single Document



<Aside>If you need to assign users and groups to roles on more than one document, it is best practice to use the [bulk API](/vault-api/api-reference/26.1/document-binder-roles/document-roles/assign-users-groups-to-roles-on-multiple-documents-binders).</Aside>
Assign users and groups to roles on a single document.

<Endpoint path="/api/{version}/objects/documents/{doc_id}/roles" method="POST"></Endpoint>

## Headers {#headers}

| Name | Description |
| --- | --- |
| `Content-Type` | `application/x-www-form-urlencoded` |
| `Accept` | `application/json` (default) or `application/xml` |

## URI Path Parameters {#uri-path-parameters}

| Name | Description |
| --- | --- |
| `{doc_id}` | The document `id` field value. |

## Body Parameters {#body-parameters}

| Name | Description |
| --- | --- |
| `{role__v}.users` | A string of comma-separated user id values for the new role. For example, `reviewer__v.users = "3003, 4005"`. |
| `{role__v}.groups` | A string of comma-separated group id values for the new group. For example, `reviewer__v.groups = "20, 21"`. |

## Request {#request}

<CodeExample title="">
```
curl -X POST -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "consumer__v.users=35565,35571" \
-d "approver__v.users-45585,45594" \
https://myvault.veevavault.com/api/v15.0/objects/documents/245/roles

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
  "responseStatus": "SUCCESS",
  "responseMessage": "Document roles updated",
  "updatedRoles": {
    "consumer__v": {
      "users": [
        19376,18234,19456
      ]
    },
    "legal__c": {
      "groups": [
        19365,18923
      ]
    }
  }
}

```
</CodeExample>

## Response Details {#response-details}

The response includes IDs of the users and groups successfully assigned to each role on the document.



---

**Previous:** [Retrieve Document Role](/commercial/vault-api/api-reference/26.1/document-binder-roles/document-roles/retrieve-document-role)  
**Next:** [Assign Users & Groups to Roles on Multiple Documents & Binders](/commercial/vault-api/api-reference/26.1/document-binder-roles/document-roles/assign-users-groups-to-roles-on-multiple-documents-binders)