> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Organization Members

> Add or remove members from an organization.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="org_id" type="string" required>
  The unique identifier of the organization.
</ParamField>

### Body

<ParamField body="action" type="string" required>
  The action to perform.\
  <br />Valid values: `"add"`, `"remove"`
</ParamField>

<ParamField body="target" type="string" required>
  Who to add or remove. Accepts an existing user ID, a phone number (E.164 format, e.g. `+14155550123`), or an email address.\
  <br />When you pass a phone number or email that doesn't match an existing user, an invitation is created. Phone number invitees receive an SMS, and email invitees receive a sign-up link. Invitees are automatically added to the organization when they sign up with the same phone number or email.
</ParamField>

<ParamField body="permissions" type="string[]">
  A list of permissions to assign when adding a member.\
  <br />Required only when `action` is `"add"`.\
  <br />Valid values: `"owner"`, `"admin"`, `"operator"`, `"viewer"`
</ParamField>

<ParamField body="is_invite" type="boolean">
  Whether the removal applies to an invite instead of a full member.\
  <br />Required only when `action` is `"remove"`.
</ParamField>

### Response

<ResponseField name="data" type="null">
  Always `null` upon successful update.
</ResponseField>

<ResponseField name="errors" type="null">
  Always `null` on success.
</ResponseField>

<ResponseExample>
  ```json Response   theme={null}
  {
    "data": null,
    "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)