---
title: "Set a member's board-only access"
url: https://docs.gleap.ai/en/reference/rest-api/update-user-access
method: PUT
path: "/projects/users/{userId}/access"
api: "API Reference"
tag: "Project"
operationId: "UpdateUserAccess"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Set a member's board-only access

`PUT https://api.gleap.io/v3/projects/users/{userId}/access`

Limit a direct project member to some boards ('edit' or 'view') and agents, or lift it with `access: null` (boardMember.logic). Organisation members cannot be limited; nobody limits themselves.

## Authorization

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

## Path parameters

- `userId` (string, required)

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

- `access` (any, required)

## Example request

```bash
curl --request PUT \
  --url 'https://api.gleap.io/v3/projects/users/{userId}/access' \
  --header 'Authorization: Bearer <token>' \
  --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)
- `userId` (string, required)

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