Sign in
Users
v1

Update User Permissions

Replaces the permissions for an existing user on the account. The submitted permissions array is applied in full — any permission identifier absent from the array is revoked. To remove all access, submit an empty array — this fully revokes the user's access on the account without deleting the user record.

:::info Requires the users:write OAuth2 scope. :::

patch/v1/account-users/{user_id}

Path parameters

user_idstring required

The ID of the user.

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Request body

Example request

{
  "data": {
    "attributes": {
      "permissions": [
        "web_visitors.product_access",
        "web_visitors.custom_feed"
      ]
    }
  }
}

Response

Account user details

Example response

{
  "data": {
    "type": "account_user",
    "id": "123456",
    "attributes": {
      "email": "jane.smith@example.com",
      "first_name": "Jane",
      "last_name": "Smith",
      "invitation_accepted": true,
      "permissions": [
        "web_visitors.product_access",
        "web_visitors.custom_feed"
      ]
    }
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes