# Version Management

Safely promote changes between tenant environments. With Version Management APIs, you can export, validate, import, and force-import tenant configurations while ensuring version and integrity checks.


## Servers

Sandbox environment
```
https://version-management.sbx.transmitsecurity.io
```

Production environment (US)
```
https://version-management.transmitsecurity.io
```

Production environment (CA)
```
https://version-management.ca.transmitsecurity.io
```

Production environment (EU)
```
https://version-management.eu.transmitsecurity.io
```

Production environment (AU)
```
https://version-management.au.transmitsecurity.io
```

## Security

### bearer

An access token generated by the [token endpoint](/openapi/token.openapi/other/getaccesstoken) using the management app credentials. Note that this token should not target any specific resource.

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Version Management](https://developer.transmitsecurity.com/_bundle/openapi/version-management/version-management.openapi.yaml)

## Other

### Export configuration

 - [GET /version/export/{tenantId}](https://developer.transmitsecurity.com/openapi/version-management/version-management.openapi/other/versioncontroller_exportversion.md): Export the full configuration of the specified tenant in JSON or ZIP format.

### Import configuration

 - [POST /version/import/{tenantId}](https://developer.transmitsecurity.com/openapi/version-management/version-management.openapi/other/versioncontroller_import.md): Import tenant configuration data with version and integrity validation.

### Force import

 - [POST /version/force-import/{tenantId}](https://developer.transmitsecurity.com/openapi/version-management/version-management.openapi/other/versioncontroller_forceimport.md): Force import tenant configuration, skipping version checks but validating structural integrity.

### Validate structure

 - [POST /version/validate/{tenantId}](https://developer.transmitsecurity.com/openapi/version-management/version-management.openapi/other/versioncontroller_validate.md): Validate the structure and version of exported data without applying it to the target tenant