---
title: "Update an invitation's board-only access"
url: https://docs.gleap.ai/en/reference/rest-api/update-invitation-access
method: PUT
path: "/invitations/{invitationId}/access"
api: "API Reference"
tag: "Invitation"
operationId: "UpdateInvitationAccess"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Update an invitation's board-only access

`PUT https://api.gleap.io/v3/invitations/{invitationId}/access`

Set (or lift, with `access: null`) the boards and agents a pending project invitation limits its invitee to.

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Path parameters

- `invitationId` (string, required)

## Headers

- `project` (string, required)

## Request body (`application/json`, required)

- `access` (any, required)

## Example request

```bash
curl --request PUT \
  --url 'https://api.gleap.io/v3/invitations/{invitationId}/access' \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>' \
  --header 'Content-Type: application/json' \
  --data '{
  "access": null
}'
```

## Responses

### 200 (`application/json`)

Ok

- `access` (object, required)
  - `boards` (object[], required)
    - `role` (enum<string>, required): One of: `edit`, `view`.
    - `type` (string, required)
  - `agents` (string[], required)
- `id` (string, required)

```json
{
  "access": {
    "boards": [
      {
        "role": "edit",
        "type": "string"
      }
    ],
    "agents": [
      "string"
    ]
  },
  "id": "string"
}
```