Table of Contents | ||||||
---|---|---|---|---|---|---|
minLevel | 2 | |||||
maxLevel | 2 | type | ||||
Table of Contents | ||||||
|
Overview
Check the list of available endpoints and methods to modify and update domains (both common and multitenant domains) using the Provisioning API:
Endpoints and methods | Description | ||||||
---|---|---|---|---|---|---|---|
/domain see below | Get a list of all the domains in a multitenant structure. | ||||||
/domain/{domainName} see below | Get basic information about a given domain in a multitenant structure. | ||||||
/domain/{domainName}/retention see below | Get the price plan retention values of the given multitenant domain. | ||||||
/domain/{domainName}/roles see below | Get details of all the roles in the given domain. | ||||||
/domain/{domainName}/roles/{roleName} see below | Get details of a specific role in a given domain. | ||||||
/domain/{domainName}/policies see below | Get the list of role policies available in a given domain. | ||||||
/domain/{domainName}/applications see below | Get the list of applications available in a given domain. | ||||||
/domain/{domainName}/resources see below | Get the list of role resources available in a given domain. | ||||||
/domain/{domainName}/roles/vaults see below | Get the list of role vaults available in a given domain. | ||||||
/domain/{domainName}/preferences see below | Retrieve the subset of preferences of the given domain. | ||||||
/domain/{domainName}/preferences/limits see below | Retrieve the limits in the preferences of the given domain. | ||||||
/domain/{domainName}/visibility see below | Returns a list of all the domains from which a root domain can access data in a multitenant structure. | ||||||
/domain/{domainName}/auth see below | Returns the configuration info of a multitenant domain. | ||||||
/domain/{domainName}/keys see below | Returns a list of all API keys associated with the given domain. | ||||||
/domain/{domainName}/keys/{key} see below | Returns info of a specific API key. | ||||||
/domain see below | Create a new domain in a multitenant structure. | ||||||
/domain/{domainName}/disable see below | Disable a multitenant domain. | ||||||
/domain/{domainName}/enable see below | Enable a multitenant domain. | ||||||
/domain/{domainName}/roles see below | Create a new role in a given a new role in a given domain. | ||||||
/domain/{domainName}/keys see below | Generate a new API key/secret pair in the domain. | ||||||
/domain/{domainName}/plan see below | Change the current plan of a multitenant domain. | ||||||
/domain/{domainName}/retention see below | Update the given domain plan retention configuration. | ||||||
/domain/{domainName}/roles see below | Update a role in a given domain. | ||||||
/domain/{domainName}/roles/{roleName} see below | Update a role. | ||||||
/domain/{domainName}/preferences see below | Update the subset of preferences of a given domain. | ||||||
/domain/{domainName}/preferences/limits see below | Update the limits in the preferences of a given domain. | ||||||
/domain/{domainName}/certificates/download see below | Download a certificate. | ||||||
/domain/{domainName}/auth see below | Update the configuration of a multitenant domain. | ||||||
/domain/{domainName} see below | Delete a domain. | ||||||
/domain/{domainName}/roles/{roleName} see below | Delete a role in a given domain. | ||||||
/domain/{domainName}/keys/{key} see below | Delete a specific API key. |
Endpoints and methods
Anchor | ||||
---|---|---|---|---|
|
/domain
Get a list of all the domains in a multitenant structure. By default, only active domains are retrieved.
...
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}
Get basic information about a given domain in a multitenant structure.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/retention
...
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/roles
...
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/roles/{roleName}
...
Expand | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Query string parametersQuery string parameters are optionally added after the path parameters, preceded by a question mark ( | |||||||||||||
Parameter | Type | Description | |||||||||||
|
| Set this to true if you want to get additional details about the role (assigned policies, resources, applications…). The default value is false. |
Code Block |
---|
https://api-us.devo.com/probio/domain/domainName@resellerName/roles/Administrator?full=true |
title | Response |
---|
Code
Description and sample body
200
Successful response. Role info retrieved.
Parameter full
set to true
:
the required role. |
Query string parameters
Query string parameters are optionally added after the path parameters, preceded by a question mark (?
) and separated by an ampersand (&
)
Parameter | Type | Description |
---|---|---|
|
| Set this to true if you want to get additional details about the role (assigned policies, resources, applications…). The default value is false. |
Find below a request example:
Code Block |
---|
https://api-us.devo.com/probio/domain/domainName@resellerName/roles/Administrator?full=true |
Expand | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/policies
Get the list of role policies (or permissions) available in a given domain.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
applications
Get the list of role policies (or permissions) applications available in a given domain, both installed and not installed.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/resources
Get the list of role resources available in a given domain. Resources refer to lookups and activeboards created in the domain.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
roles/vaults
Get the list of applications role vaults available in a given domain, both installed and not installed.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | |||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||
|
...
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
preferences
Get Retrieves the list of role resources available in a given domain. Resources refer to lookups and activeboards created in the subset of preferences of the given domain.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
...
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
preferences/
...
limits
Retrieve the limits in the preferences of the given domain.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||
|
...
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
visibility
Returns a list of all the domains from which a root domain can access data in a multitenant structure.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
auth
Retrieve the limits in the preferences of the given Returns the configuration info of a multitenant domain.
Note |
---|
Note that this request requires multitenant API credentials. |
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||
|
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
keys
Returns a list of all the domains from which a root domain can access data in a multitenant structureAPI keys associated with the given multitenant domain.
Note |
---|
Note that this request will only return API keys, not API secrets. |
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
|
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
keys/{key}
Returns the configuration info information of a multitenant domain.
...
specific API key.
Expand | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
200 Successful response. List of domains retrieved. Code Block |
|
Anchor | ||||
---|---|---|---|---|
|
/domain
Create a new domain in a multitenant structure.
Expand | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||
Request bodyThe request JSON body must include the
Find below a request example:
And this is an example of a request body, including the required JSON object:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/disable
Disable a multitenant domain.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/enable
...
Domains with the status pending cannot be activated. Also, when you try to disable or enable an already disabled or enabled domain, you will get an error response.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/roles
Create a new role in a given domain.
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Request bodyThe request JSON body must include the
Currently, these parameters cannot be changed through the API but can be requested:
Find below a request example:
And this is an example of a request body, including the required JSON object:
Currently, these parameters cannot be changed through the API but can be requested: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Parameter | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| The default vault (querying priority level) defined for the role. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| The maximum vault defined to be used in the role. |
Note |
---|
Using the Admin users need some additional permissions in order to use the |
Find below a request example:
Code Block |
---|
https://api-us.devo.com/probio/domain/domainName@resellerName/roles |
And this is an example of a request body, including the required JSON object:
,
"editable": 1 }
],
} |
Expand | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/keys
Creates a new API key/secret pair for the domain. The autogenerated credentials are returned in the response. The request body of this request must be empty.
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/plan
Change the current plan of a multitenant domain. The new plan must be valid for the multitenant structure and different from the current one.
Expand | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Query string parametersQuery string parameters are added after the path parameters, preceded by a question mark (
Find below a request example:
|
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/retention
Update the price plan configuration (retention & volume) of a given domain. Partial updates are permitted.
Expand | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Request bodyThe request JSON body must include the
Find below a request example:
And this is an example of a request body, including the required JSON object:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/roles
Updates a domain custom role in a given domain.
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Request bodyThe request JSON body must include the
Currently, these parameters cannot be changed through the API but can be requested:
Find below a request example:
And this is an example of a request body, including the required JSON object:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/roles/{roleName}
Updates a domain custom role.
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Request bodyThe request JSON body must include the
Currently, these parameters cannot be changed through the API but can be requested:
Find below a request example:
And this is an example of a request body, including the required JSON object:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/preferences
Update the subset of preferences of a given domain.
Expand | |||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Request bodyThe request JSON body must include the
Find below a request example:
And this is an example of a request body, including the required JSON object:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/preferences/limits
Update the limits in the preferences of a given domain.
Expand | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Request bodyThe request JSON body must include the
Find below a request example:
And this is an example of a request body, including the required JSON object:
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/certificates/download
Download the certificates of a given domain.
Expand | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Query string parametersQuery string parameters are added after the path parameters, preceded by a question mark (
Depending on the parameters given, the behavior will be different:
Find below a request example:
|
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}/auth
...
Note |
---|
Note that this request requires multitenant API credentials. |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Request bodyThe request JSON body must include the SAML
OpenID
Password
Find below a request example:
And these are examples of the required JSON bodies: SAML
OpenID
Password
|
Anchor | ||||
---|---|---|---|---|
|
/domain/{domainName}
Delete a multitenant domain. This will additionally delete all user domains belonging to the multitenant domain. Any user that ends up without at least one user domain will be deleted as well.
Note |
---|
Note that this request requires multitenant API credentials. |
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||
|
...
Anchor |
---|
...
|
...
|
/domain/{domainName}/roles/{roleName}
Delete a multitenant domain. This will additionally delete all user domains belonging to the multitenant domain. Any user that ends up without at least one user domain will be deleted as well.
Note |
---|
Note that this request requires multitenant API credentials. |
role in a given domain. Note that a role cannot be deleted while it is assigned to a user.
Expand | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
Find below a request example:
|
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
|
Anchor |
---|
...
|
...
|
/domain/{domainName}/
...
keys/{
...
key}
Delete a role in a given domain. Note that a role cannot be deleted while it is assigned to a userspecific API key from the given domain.
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Path parametersAdd the following path parameters as part of the endpoint:
roleName
Find below a request example:
|
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
|