---
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# New v3 API endpoints for organization-level operations

When you sign in to your BILL developer account with `POST /v3/login`, you sign in as a user of the BILL organization. In the API response, `userId` is the BILL-generated ID of the signed-in user.

## Organization operations

We have introduced a set of organization API endpoints for organization-level users.

| Operation                                                                            | API endpoint                               |
| :----------------------------------------------------------------------------------- | :----------------------------------------- |
| [Get organization details](https://developer.bill.com/v3/reference/getorganization)  | `GET /v3/organizations/{organizationId}`   |
| [Update an organization](https://developer.bill.com/v3/reference/updateorganization) | `PATCH /v3/organizations/{organizationId}` |

## User operations

As a user with the `ADMINISTRATOR` user role in a BILL organization, you can use the BILL API to create other users and also manage user access in the BILL organization.

We have introduced a set of user API endpoints for organization-level users.

| Operation                                                                                   | API endpoint                       |
| :------------------------------------------------------------------------------------------ | :--------------------------------- |
| [Create a user](https://developer.bill.com/v3/reference/createorganizationuser)             | `POST /v3/users`                   |
| [Get user details](https://developer.bill.com/v3/reference/getorganizationuser)             | `GET /v3/users/\{userId}`          |
| [Update a user](https://developer.bill.com/v3/reference/updateorganizationuser)             | `PATCH /v3/users/\{userId}`        |
| [Archive a user](https://developer.bill.com/v3/reference/archiveorganizationuser)           | `POST /v3/users/\{userId}/archive` |
| [Restore an archived user](https://developer.bill.com/v3/reference/restoreorganizationuser) | `POST /v3/users/\{userId}/restore` |
| [Get list of user roles](https://developer.bill.com/v3/reference/listorganizationuserroles) | `GET /v3/roles`                    |
| [Get user role details](https://developer.bill.com/v3/reference/getorganizationuserrole)    | `GET /v3/roles/{roleId}`           |

See [Organizations and Users](https://developer.bill.com/v3/docs/organizations-users) for more information.