added
New v3 API endpoints for organization-level operations
April 22nd, 2024
When you sign in to your BILL developer account with /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 | GET /v3/organizations/{organizationId} |
| Update an organization | 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 | POST /v3/users |
| Get user details | GET /v3/users/{userId} |
| Update a user | PATCH /v3/users/{userId} |
| Archive a user | POST /v3/users/{userId}/archive |
| Restore an archived user | POST /v3/users/{userId}/restore |
| Get list of user roles | GET /v3/roles |
| Get user role details | GET /v3/roles/{roleId} |
See Organizations and Users for more information.