The Devo Provisioning API can be used to:
- Retrieve information of users and domains.
- Create, update, delete and modify Devo domains, and also enable or disable them.
- Create, update, delete and modify Devo users, and also enable or disable them.
- Get lists of available reseller domains and users in a specific domain.
- Retrieve and update a domain's plan configuration and ingestion limits in Devo.
- Retrieve lists of plans associated to a reseller and information of specific plans.
- Get the certificates associated to specific Devo domains.
To perform a request with the Provisioning API, use the endpoint for your Devo region:
The following articles define the operations you can perform using the Devo Provisioning API. Additionally, see the Devo Provisioning API documentation in Swagger to see in detail the paths and parameters you can add to the endpoint URL in order to perform the available types of requests.
The Provisioning API operations are divided in two main groups:
- Common operations - These operations can be applied both for common and reseller domains.
- Reseller operations - See this article to see a set of operations related to reseller domains only.
Every Provisioning API response sends a special header named
x-devo-cid, which contains the correlation ID generated for the request. In case of any problem, add this value to your support request so that the problem can be traced more effectively.
Common and reseller domain names
The name format for common and reseller domains is not the same. Common domains have regular names (with certain character restricitons, but they don't need to follow a fixed format), while reseller domain names are followed by the name of the reseller they belong to, separated by an @ (domain_name@reseller).
This tail can be ignored when you create a new reseller domain, but keep in mind that it must be added in all the operations that require the name of the domain; otherwise, they will return an error. For example, if you create a domain called my_domain in the reseller test, you will have a domain called my_domain@test. Any further operations will require this name format to work properly.
Regular names (like domain names) need to match the regular expression
([A-Za-z])+([A-Za-z0-9_-]), which basically requires the name not to be a number, and use only lower or uppercase letters, or characters _ and -.
User names use a more lax restriction, allowing things like accents, dots, @ characters, etc.