# Devices

This API exposes operations that allow applications to register and manage device entities in Mosaic. Use it to add new devices, list a user's devices, delete devices, and more.


## Servers

Sandbox environment
```
https://api.sbx.transmitsecurity.io/cis
```

US production environment
```
https://api.transmitsecurity.io/cis
```

EU production environment
```
https://api.eu.transmitsecurity.io/cis
```

CA production environment
```
https://api.ca.transmitsecurity.io/cis
```

AU production environment
```
https://api.au.transmitsecurity.io/cis
```

JP production environment
```
https://api.gasne1-ts01.transmitsecurity.io/cis
```

## Security

### bearer

Type: http
Scheme: bearer
Bearer Format: JWT

### UserAccessToken

A token returned upon end-user authentication, which provides access to resources and data for the user and app for which it was generated

Type: http
Scheme: bearer
Bearer Format: JWT

### AdminAccessToken

[object Object]

Type: oauth2
Token URL: /oidc/token
Scopes:

### ClientAccessToken

[object Object]

Type: oauth2
Token URL: /oidc/token
Scopes:

### OrgAdminAccessToken

A token returned upon B2B authentication for a user that has the organizationAdmin or organizationCreator role.

Type: oauth2
Token URL: /oidc/token
Scopes:

## Download OpenAPI description

 - [Devices](https://developer.transmitsecurity.com/_bundle/openapi/user/devices.openapi.yaml)

 - [POST /v1/users/{user_id}/devices](https://developer.transmitsecurity.com/openapi/user/devices.openapi/other/createorupdatedevice.md): Registers a new device for the given user, or updates metadata of an existing one. This requires a **client access token** of the application, and must be called from the backend. **Required permissio
 - [GET /v1/users/{user_id}/devices](https://developer.transmitsecurity.com/openapi/user/devices.openapi/other/getdevices.md): Retrieves all devices registered for the given user. This requires a **client access token** of the application, and must be called from the backend. **Required permissions**: `apps:read`, `[appId]:re
 - [GET /v1/users/{user_id}/devices/{device_id}](https://developer.transmitsecurity.com/openapi/user/devices.openapi/other/getdevicebyid.md): Retrieves a specific device of the given user. This requires a **client access token** of the application, and must be called from the backend. **Required permissions**: `apps:read`, `[appId]:read`, `
 - [PUT /v1/users/{user_id}/devices/{device_id}](https://developer.transmitsecurity.com/openapi/user/devices.openapi/other/updatedevice.md): Updates metadata fields of a specific device of the given user. This requires a **client access token** of the application, and must be called from the backend. **Required permissions**: `apps:edit`,
 - [DELETE /v1/users/{user_id}/devices/{device_id}](https://developer.transmitsecurity.com/openapi/user/devices.openapi/other/deletedevice.md): Deletes a specific device of the given user. This requires a **client access token** of the application, and must be called from the backend. **Required permissions**: `apps:delete`, `[appId]:delete`,
 - [POST /v1/users/{user_id}/devices/{device_id}/suspend](https://developer.transmitsecurity.com/openapi/user/devices.openapi/other/suspenduserdevice.md): Suspends the specified device for the given user. This requires a **client access token** of the application, and must be called from the backend. **Required permissions**: `apps:edit`, `[appId]:edit`
 - [POST /v1/users/{user_id}/devices/{device_id}/reactivate](https://developer.transmitsecurity.com/openapi/user/devices.openapi/other/reactivateuserdevice.md): Reactivates the specified device for the given user. This requires a **client access token** of the application, and must be called from the backend. **Required permissions**: `apps:edit`, `[appId]:ed
 - [GET /v1/devices](https://developer.transmitsecurity.com/openapi/user/devices.openapi/other/filterdevices.md): Filters and lists devices within the application. This requires a **client access token** of the application, and must be called from the backend. **Required permissions**: `apps:read`, `[appId]:read`