---
title: "Update Organization Members"
method: PUT
path: "/orgs/{org_id}/members"
tags: ["Organizations"]
---

# Update Organization Members

`PUT /orgs/{org_id}/members`

## Request

- Base URL: `https://dataops.nexla.io/nexla-api`
- URL: `https://dataops.nexla.io/nexla-api/orgs/{org_id}/members`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nexla/apis/nexla-rest-api/docs/orgs/:org_id/members/put.ts> (a function with typed inputs; its response is checked against the schema)

Add or update members in an organization. This endpoint can also be used to modify an existing member's role in the organization.

When adding a new member using their email id, if a user account for that email id does not exist on the platform then a new user account will be created. If the user already exists on the platform as a member of a different organization then their membership will get updated to include this organization also.

## Path parameters

- `org_id` integer, required

## Request body

- OrgMemberList
  - `members` OrgMemberMutable[]
    - union
      - object
        - `id` integer, required: Nexla User ID of the user to be added or updated.
        - `access_role` string[]: This property reflects all the permissions the user/team/organization has to this resource. 1. `collaborator`: The user/team/organization can view the resource but not make any modifications to it. 2. `operator`: The user/team/organization can view the resource and can activate/pause it, but not make any other modifications to it. 3. `administrator`: The user/team/organization has complete administrative rights to this resource. 4. `owner`: This user created the resource and so has complete administrative rights to it.
      - object
        - `email` string, required: Email ID of the user to be added or updated. If a user with this Email ID already exists on the platform then the API will update that account with this membership rule.
        - `access_role` string[]: This property reflects all the permissions the user/team/organization has to this resource. 1. `collaborator`: The user/team/organization can view the resource but not make any modifications to it. 2. `operator`: The user/team/organization can view the resource and can activate/pause it, but not make any other modifications to it. 3. `administrator`: The user/team/organization has complete administrative rights to this resource. 4. `owner`: This user created the resource and so has complete administrative rights to it.

## Response `200`

Success

- OrgMember[]
  - `id` integer: Nexla User ID of this user.
  - `full_name` string
  - `email` string
  - `is_admin?` boolean: Indicates whether this user is an administrator for the organization or not.
  - `access_role` string[]: This property reflects all the permissions the user/team/organization has to this resource. 1. `collaborator`: The user/team/organization can view the resource but not make any modifications to it. 2. `operator`: The user/team/organization can view the resource and can activate/pause it, but not make any other modifications to it. 3. `administrator`: The user/team/organization has complete administrative rights to this resource. 4. `owner`: This user created the resource and so has complete administrative rights to it.
  - `org_membership_status` 'ACTIVE' | 'DEACTIVATED': Indicates whether the user's membership in this organization is active or not. If the membership is DEACTIVATED the user can no longer access the account but the resources owned by them will still be accessible by the organization administrators.
  - `user_status` 'ACTIVE' | 'DEACTIVATED' | 'SOURCE_COUNT_CAPPED' | 'SOURCE_DATA_CAPPED' | 'TRIAL_EXPIRED': Indicates the user's account status across all organizations they are members of.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/nexla/apis/nexla-rest-api.md) - [All operations](https://skmtc.dev/nexla/apis/nexla-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nexla/apis/nexla-rest-api/revisions/ef02be92fe7b?raw)