---
title: "Approve user invitation"
source_url: https://dev.digicert.com/certcentral-apis/services-api/users/approve-user-invitation.html
api_method: PUT
api_endpoint: "/services/v2/user/invite/{{invitation_id}}/status"
api_url: "https://www.digicert.com/services/v2/user/invite/{{invitation_id}}/status"
---

**PUT** `https://www.digicert.com/services/v2/user/invite/{{invitation_id}}/status`

Use this endpoint to approve a user invitation and assign container (division) access and access roles to the user. To get the invitation ID, use the [List user invitations](https://dev.digicert.com/md/certcentral-apis/services-api/users/list-user-invitations.md) endpoint. 

## Example requests and responses

**cURL**

```bash
curl --request PUT \
  --url 'https://www.digicert.com/services/v2/user/invite/{{invitation_id}}/status' \
  --header 'Content-Type: application/json' \
  --header 'X-DC-DEVKEY: {{api_key}}' \
  --data-raw '{
  "status": "approved",
  "processor_comment": "Some Comment",
  "requested_user": {
    "container_id_assignments": [
      "92231",
      "378222"
    ],
    "access_roles": [
      {
        "id": "1"
      }
    ]
  }
}'
```


## 200 OK

```json
// empty
```

## Filters and URL query parameters

This endpoint does not support filters or URL query parameters.

## Path parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>invitation_id</td>
<td>required</td>
<td>int</td>
<td>Invitation ID. Get this value from the <code>invites[].id</code> response parameter returned by the <a href="../list-user-invitations/">List user invitations</a> endpoint.</td>
</tr>
</tbody>
</table>

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>status</td>
<td>required</td>
<td>string</td>
<td>New status for the invitation.<br>For this workflow, use <code>approved</code>.</td>
</tr>
<tr>
<td>processor_comment</td>
<td>optional</td>
<td>string</td>
<td>Comment recorded with the invitation approval.</td>
</tr>
<tr>
<td>requested_user</td>
<td>required</td>
<td>object</td>
<td>Container assignments and access roles to apply to the approved user.</td>
</tr>
<tr>
<td>.. container_id_assignments</td>
<td>required</td>
<td>array of strings</td>
<td>List of container (division) IDs to assign to the user. A user with container assignments can access only the assigned containers. Pass an empty array to give the user access to all containers in the account. For more information, see <a href="https://dev.digicert.com/md/certcentral-apis/services-api/users/update-container-assignments.md">Update container assignments</a>.</td>
</tr>
<tr>
<td>.. access_roles</td>
<td>required</td>
<td>array of objects</td>
<td>Access roles to assign to the user.</td>
</tr>
<tr>
<td>.. .. id</td>
<td>required</td>
<td>string</td>
<td>Access role ID.<br>Allowed values:<br><ul><li><code>1</code>: Administrator - Full administrative access, including managing divisions, users, and user access.</li><li><code>2</code>: Limited user - Can place and manage only their own orders.</li><li><code>3</code>: Finance manager - Can manage finances and place and manage orders.</li><li><code>4</code>: Manager - Can manage finances, create and approve requests, manage orders and domains, and view and edit users.</li><li><code>5</code>: Standard user - Can place and manage orders; changes require approval by a manager or administrator.</li></ul>See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#access-roles">Glossary - Access roles</a>.</td>
</tr>
</tbody>
</table>

## Response parameters

The endpoint returns HTTP 200 when the invitation is approved and the user assignments are applied.