# Consents

Manage consent requests and consents. These APIs allow third party clients to request consent from app users. They also allow users to grant consent requests, view all consents related to their account, and revoke any granted permissions.


## Servers

Production environment (US, worldwide, except EU & Canada)
```
https://api.transmitsecurity.io/cis
```

Production environment (EU)
```
https://api.eu.transmitsecurity.io/cis
```

Production environment (CA)
```
https://api.ca.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

A token generated by a management application using the [token endpoint](/openapi/token.openapi/other/getaccesstoken). It provides access to all resources for the tenant and its apps

Type: oauth2

### ClientAccessToken

A token generated by an end-user application using the [token endpoint](/openapi/token.openapi/other/getaccesstoken). It provides access to resources and data on the tenant level or associated with the specific application (but not other apps in the tenant)

Type: oauth2

### OrgAdminAccessToken

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

Type: oauth2

## Download OpenAPI description

[Consents](https://developer.transmitsecurity.com/_bundle/openapi/user/consents.openapi.yaml)

## Other

### Get all consents

 - [GET /v1/consents](https://developer.transmitsecurity.com/openapi/user/consents.openapi/other/getallconsents.md): Retrieve all consents. Required permissions: apps:read, [appId]:read, consents:read.

### Get consent by ID

 - [GET /v1/consents/{consentId}](https://developer.transmitsecurity.com/openapi/user/consents.openapi/other/getconsent.md): Retrieve a consent by ID. Required permissions: apps:read, [appId]:read, consents:read.

### Delete consents by user ID

 - [DELETE /v1/consents/clients/{clientId}/users/{userId}](https://developer.transmitsecurity.com/openapi/user/consents.openapi/other/deleteappconsents.md): Delete consents by user ID. If no consent ID is provided, all consents for the user are deleted. Required permissions: apps:delete, [appId]:delete, consents:delete.

### Get all consents for an app

 - [GET /v1/manage/consents](https://developer.transmitsecurity.com/openapi/user/consents.openapi/other/getallappconsents.md): Retrieve all consents for an app. Required permissions: apps:read, [appId]:read, consents:read.

### Delete consents by client ID

 - [DELETE /v1/manage/consents/clients/{clientId}/users/{userId}](https://developer.transmitsecurity.com/openapi/user/consents.openapi/other/deleteclientconsents.md): Delete consents by client ID. If no consent ID is provided, all consents for the client are deleted. Required permissions: apps:delete, [appId]:delete, consents:delete.

### Get all consents for current user

 - [GET /v1/consents/me](https://developer.transmitsecurity.com/openapi/user/consents.openapi/other/getalluserconsents.md): Get all consents for current user

### Revoke a consent by ID for current user

 - [DELETE /v1/consents/me/clients/{clientId}](https://developer.transmitsecurity.com/openapi/user/consents.openapi/other/deleteuserconsents.md): Revoke a consent by ID for current user.