# Elevate Authentication & Users API

### Authentication

Elevate API uses Bearer authentication (also called token authentication) - this is an HTTP authentication scheme that uses security tokens called bearer tokens
The bearer tokens used by Elevate are the industry standard [JSON Web Tokens](http://jwt.io) (JWT)

The client can obtain the token from this endpoint and must send this token in the Authorization header when making requests to other endpoints
Tokens will be valid for 15 minutes before a new token must be obtained


Version: 1.5

## Servers

```
https://rest.elevatebilling.com/v1
```

## Security

### bearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Elevate Authentication & Users API](https://docs.elevatebilling.com/_bundle/openapi/prod/gen/billing-rest-authentication.yaml)

## authentication

The Elevate REST API uses JWT Bearer tokens for authentication

### Create bearer token

 - [POST /authenticate](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/authentication/createbearertoken.md)

## users

An identification used by a person with access to Elevate

### Get a list of available users

 - [GET /users](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/users/getusers.md)

### Check if user exists

 - [HEAD /users](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/users/checkuser.md)

### Create a user

 - [POST /users](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/users/createuser.md)

### Get a specific user

 - [GET /users/{user_id}](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/users/getuser.md)

### Update a user

 - [PATCH /users/{user_id}](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/users/updateuser.md)

## user-roles

Permission groups that can be assigned to users

### Get a list of available user roles

 - [GET /user-roles](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/user-roles/getuserroles.md)

## app-clients

An identification used by a service that access Elevate APIs programmatically

### Get a list of App Clients

 - [GET /app-clients](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/app-clients/getappclients.md)

### Create an App Client

 - [POST /app-clients](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/app-clients/createappclient.md)

### Get App Client by ID

 - [GET /app-clients/{id}](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/app-clients/getappclient.md)

### Update App Client

 - [PATCH /app-clients/{id}](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/app-clients/updateappclient.md)

### Delete App Client

 - [DELETE /app-clients/{id}](https://docs.elevatebilling.com/openapi/prod/gen/billing-rest-authentication/app-clients/deleteappclient.md)