Resellers
A reseller refers to a "second level" indirect sales partner who resells the services offered by the Fusion platform. A reseller
API Authorization
These APIs are only available for system administrators, group administrators and distributor administrators.
Get a list of resellers
List all resellers created on the platform.
Returned data depends on your user profile
When this endpoint is consumed by a reseller, the API will only return the resellers directly linked to the reseller in question.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers
Authorization
Required role
resellers.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
search | string | Used to perform a search through all searchable properties of a reseller that look like the string passed | no |
sort | string | Allows to specify one searchable property of a reseller to apply a sorting operation | no |
dir | string | When performing a sort operation, specifies the type. Allowed values are asc for ascending (default) or desc for descending | no |
parent | string | Specify a group or distributor UUID. Only resellers served by this specific UUID parent group or distributor are returned | yes |
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
next | string | A token used to get the next records in the list. This token is taken back from the results of the previous call | no |
Use of parent query parameter
If logged as a system administrator the API consumer has to provide a parent UUID, otherwise the system doesn't know to which parent entity the request reports to.
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more resellers found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No reseller found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
results | integer | Total number of results from the query | no |
pages | integer | Total number of pages according to pagination settings | no |
page | integer | Current displayed page from the set of pages | no |
next | string | A token used for infinite scrolling, to be used in the next call to retrieve subsequent records. Only present if the list of resellers has to be continued | yes |
resellers | array | List containing all reseller objects in the system or the reseller objects filtered by a reseller ID | no |
Reseller Object
| Parameter | Type | Description | Conditional? | Searchable? |
|---|---|---|---|---|
uuid | string | Universal unique id uniquely identifying the reseller | no | no |
name | string | Name the reseller | no | yes |
billingId | string | External ID used in CDR as billing reference (unique per Group). | no | yes |
owner | object | See owner. Only present when used without query parameter or attached to a distributor | yes | no |
markup | float | latest active markup defined for the reseller in percentages | yes | no |
status | string | Current status of the reseller | yes | no |
Example
json
{
"results": 2,
"pages": 5,
"page": 1,
"next": "cGFyZW50PTNhNGFmYmQzLWYxZDctNGY4NS1iZDU5LWE0MDU2N2YyMDYzOSZwYWdlPTI=",
"resellers": [
{
"uuid": "04237dff-d765-45cd-9cf5-ae9d5dba14b1",
"name": "Distributor-less reseller NL 1",
"billingId": "cloudblue::reseller::27",
"markup": 20.0,
"status": "suspended"
},
{
"uuid": "7c94597e-2860-4c15-b13f-2e56b71bf0f4",
"name": "Netaxis NL Reseller 1",
"owner": {
"type": "distributor",
"uuid": "19cb4904-2b26-4982-8706-dfac061c07af",
"name": "Netaxis NL Distributor"
},
"billingId": "cloudblue::reseller::14",
"markup": 20.0
}
]
}Get a specific reseller
The following endpoint gives the details of a single reseller.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}
Authorization
Required role
resellers.instance.read
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to get its details |
URL/Query parameters
N/A
Response
Status codes
| Parameter | Description |
|---|---|
200 | The reseller was found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No reseller found with this uuid |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
uuid | string | Universal unique id uniquely identifying the reseller | no |
name | string | Name the reseller | no |
billingId | string | External ID used in CDR as billing reference (unique per Group). | no |
owner | object | See owner. Only present when attached to a distributor | yes |
status | string | Current status of the reseller | yes |
markups | array | List of markups defined for the reseller, sorted on startDate from nearest to oldest. See markup for complete details | yes |
nbOfTenants | integer | Number of tenants linked to the reseller | no |
Example
json
{
"uuid": "016ff8cb-482c-4bfc-8bd8-5a8e07898cce",
"name": "Easi1",
"billingId": "939381",
"owner": {
"type": "distributor",
"uuid": "14e98062-9073-4d2c-ae01-5c8c23437f5e",
"name": "Gersonisos nv"
},
"markups": [
{
"markup": "0.0",
"startDate": "2022-05-23T14:35:02.705016"
},
{
"markup": "10.0",
"startDate": "2022-01-01T21:42:07.234119"
}
],
"nbOfTenants": 8
}Create a new reseller
Use this endpoint to create a new reseller on the platform.
Request
Endpoint
POST /api/v01/draas/{draas_instance}/resellers
Authorization
Required role
resellers.create
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
name | string | Name the reseller | yes |
owner | object | See owner. If not provided, the reseller will be directly attached to the level to which the user who creates the reseller belongs to. E.g. when a distributor administrator creates the tenant, the tenant will be directly attached to the reseller in question. | yes / no |
billingId | string | External ID used in CDR as billing reference (unique per Group). | no |
markup | float | Markup applicable for the reseller in percentages | no |
adminEmail | string | Email of an administrator for this reseller. If present, it will create an administrator as described by this API | no |
Use of owner body parameter
If logged as a system administrator the API consumer has to provide a group or distributor owner UUID, otherwise the system doesn't know to which group or distributor entity the reseller is linked to.
Example
json
{
"name": "Reseller Test",
"owner": {
"type": "reseller",
"uuid": "04237dff-d765-45cd-9cf5-ae9d5dba14b1"
},
"billingId": "cloudblue::distributor::28",
"markup": 5.0,
"adminEmail": "john.doe@netaxis.be"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The reseller was created successfully |
400 | Error while creating the reseller |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
uuid | string | Universal unique id uniquely identifying the reseller | no |
Example
json
{
"uuid": "4a556df2-0276-4102-acdf-c9f205715515"
}Modify an existing reseller
Update the details of a given reseller
Changing the reseller's owner
It is currently not possible to update the reseller's owner through API.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/resellers/{uuid}
Authorization
Required role
resellers.instance.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to get its details |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
name | string | New name for the reseller | no |
billingId | string | New external ID used in CDR as billing reference (unique per Group). | no |
markup | float | New markup applicable for the reseller in percentages | no |
Example
json
{
"markup": 12.3
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The reseller was updated successfully |
400 | Error while updating the reseller |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
uuid | string | Universal unique id uniquely identifying the reseller | no |
Example
json
{
"uuid": "4a556df2-0276-4102-acdf-c9f205715515"
}Delete a reseller
Delete a reseller
resellers must be empty
It is not possible to delete resellers that still have tenant sattached. Proceed with care because this will also delete all related price markups related to the reseller
Request
Endpoint
DELETE /api/v01/draas/{draas_instance}/resellers/{uuid}
Authorization
Required role
resellers.instance.delete
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller which you would like to delete |
URL/Query parameters
N/A
Body
N/A
Response
Status codes
| Parameter | Description |
|---|---|
200 | The reseller was deleted successfully. If the reseller didn't exist, the delete will be considered as being executed successfully |
400 | Error while deleting the reseller |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
uuid | string | Universal unique id uniquely identifying the reseller that has been deleted | no |
Example
json
{
"uuid": "4a556df2-0276-4102-acdf-c9f205715515"
}Modify the suspension profile
Update the suspension profile for an existing reseller
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/resellers/{uuid}/suspension_profile
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated universal unique ID (UUID) identifying the reseller for which you want to modify its suspension profile |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
suspensionProfileId | integer | Index of the suspension profile as returned by this endpoint or null if you want to remove any suspension | yes |
Example
json
{
"suspensionProfileId": null
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The suspension profile was updated successfully |
400 | Error while updating the suspension profile |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
uuid | string | Universal unique id uniquely identifying the reseller | no |
Example
json
{
"uuid": "4a556df2-0276-4102-acdf-c9f205715515"
}Create an administrator account for a reseller structure
Create an administrator account for an existing reseller. The account will be created using an e-mail as user reference. At successful creation, an e-mail will be sent to the newly created administrator address, asking her/him to follow a link to create a valid password and validate the account.
Request
Endpoint
POST /api/v01/draas/{draas_instance}/resellers/{uuid}/admins
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated universal unique ID (UUID) identifying the reseller for which you want to create an administrator account |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
adminEmail | string | A valid e-mail address owned by the administrator | yes |
firstName | string | First name of the administrator | no |
lastName | string | Last name of the administrator | no |
mobile | string | Mobile phone number of the administrator | no |
Example
json
{
"adminEmail": "john.doe@netaxis.be",
"firstName": "John",
"lastName": "Doe",
"mobile": "+33613575607"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The administrator account was successfully created |
400 | Error while creating the administrator account, the specified e-mail address already exists in the system |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | number | Internal ID of newly created administrator account | no |
Example
json
{
"id": 86
}Modify an administrator account for a reseller structure
Modify an existing administrator account for a reseller. As the e-mail is the administrator reference, it cannot be modified. In case this is needed, administrator has to be deleted and re-created with the new e-mail reference.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/resellers/{uuid}/admins/{username}
Authorization
Required role
resellers.instance.admins.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated universal unique ID (UUID) identifying the reseller for which you want to create an administrator account |
username | string | The username that identifies the administrator. This should be the administrator e-mail |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
firstName | string | First name of the administrator | no |
lastName | string | Last name of the administrator | no |
mobile | string | Mobile phone number of the administrator | no |
adminEmail | string | The email of the administrator | yes |
force_reset | boolean | Forces the password reset | yes |
Example
json
{
"firstName": "John",
"lastName": "Doe",
"mobile": "+33613575607",
"adminEmail": "john.doe@netaxis.be"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The administrator account was successfully modified |
400 | Error while modifying the administrator account |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | number | Internal ID of modified administrator account | no |
Example
json
{
"id": 86
}Delete an administrator account for a reseller structure
Delete an existing administrator account from a reseller.
Request
Endpoint
DELETE /api/v01/draas/{draas_instance}/resellers/{uuid}/admins/{username}
Authorization
Required role
resellers.instance.admins.delete
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated universal unique ID (UUID) identifying the reseller for which you want to create an administrator account |
username | string | The username that identifies the administrator. This should be the administrator e-mail |
URL/Query parameters
N/A
Body
N/A
Response
Status codes
| Parameter | Description |
|---|---|
204 | The administrator account was successfully deleted |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
N/A
Send a welcome email to a reseller admin
Use this endpoint to send a welcome email to a reseller admin.
Request
Endpoint
POST /api/v01/draas/{draas_instance}/resellers/{uuid}/admins/welcome
Authorization
Required role
resellers.instance.admins.welcome.create
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
adminEmail | string | Email of an administrator for this reseller | yes |
Example
json
{
"adminEmail": "john.doe@netaxis.be"
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The welcome email has been sent successfully |
400 | Error while sending the welcome email |
500 | Uncatched error on server side |
Success
Body
N/A
Example
N/A
Get the list of pstn usages
The following endpoint gives the list of existing pstn usages for the owner group of the given reseller.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/voice_routing/pstn_usages
Authorization
Required role
resellers.instance.configurations.voice_routing.pstn_usages.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller from which you want to read properties |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
search | string | Used to perform a search through all searchable properties that look like the string passed | no |
sort | string | Allows to specify one searchable property of an order to apply a sorting operation | no |
dir | string | When performing a sort operation, specifies the type. Allowed values are asc for ascending (default) or desc for descending | no |
page | integer | Used for pagination, determines the current page to be shown (defaults to 1) | no |
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
next | string | A token used to get the next records in the list. This token is taken back from the results of the previous call | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more pstn usages found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No of the pstn usage found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
pstnUsages | array | List containing all pstn usage objects of the group | no |
results | string | Total count of results that match your query | no |
pageSize | string | Results are not provided all at once. This parameter indicates how many results are returned per page. | no |
pages | string | Total count of result pages that are available | no |
page | string | ID of the page that is currently returned | no |
next | string | A token generated as long as there are still pages to display in the list. This token may be used in a subsequent call to get the next page. It contains all query parameter from the request so they may be omitted in subsequent call | yes |
PSTN Usage Object
| Parameter | Type | Description | Conditional? | Searchable? |
|---|---|---|---|---|
id | integer | Index of the pstn usage | no | no |
name | string | Name of the pstn usage | no | yes |
Example
json
{
"page": 1,
"pageSize": 10,
"pages": 1,
"pstnUsages": [
{
"id": 21,
"name": "PSTN Test name"
},
{
"id": 8,
"name": "PSTN-Usage-DRAAS"
}
],
"results": 2
}Get the list of voice routes
The following endpoint gives the list of existing voice routes for the owner group of the given reseller.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/voice_routing/voice_routes
Authorization
Required role
resellers.instance.configurations.voice_routing.voice_routes.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller from which you want to read properties |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
search | string | Used to perform a search through all searchable properties that look like the string passed | no |
sort | string | Allows to specify one searchable property of an order to apply a sorting operation | no |
dir | string | When performing a sort operation, specifies the type. Allowed values are asc for ascending (default) or desc for descending | no |
page | integer | Used for pagination, determines the current page to be shown (defaults to 1) | no |
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
next | string | A token used to get the next records in the list. This token is taken back from the results of the previous call | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more voice routes found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No of the voice route found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
voiceRoutes | array | List containing all voice route objects of the group | no |
results | string | Total count of results that match your query | no |
pageSize | string | Results are not provided all at once. This parameter indicates how many results are returned per page. | no |
pages | string | Total count of result pages that are available | no |
page | string | ID of the page that is currently returned | no |
next | string | A token generated as long as there are still pages to display in the list. This token may be used in a subsequent call to get the next page. It contains all query parameter from the request so they may be omitted in subsequent call | yes |
Voice Route Object
| Parameter | Type | Description | Conditional? | Searchable? |
|---|---|---|---|---|
id | integer | Index of the voice route | no | no |
name | string | Name of the voice route | no | yes |
pattern | string | Pattern | no | no |
priority | integer | Priority | no | no |
pstnUsages | array | Array of pstn usage objects connected connected to the voice route | no | no |
Example
json
{
"page": 1,
"pageSize": 10,
"pages": 1,
"results": 2,
"voiceRoutes": [
{
"id": 7,
"name": "VR-DRaaS",
"pattern": ".*",
"priority": 1,
"pstnUsages": []
},
{
"id": 21,
"name": "VR-DRaaS New",
"pattern": ".*",
"priority": 5,
"pstnUsages": [
{
"id": 8,
"name": "DRaaS-New-PSTN-Usage 3"
},
{
"id": 21,
"name": "PSTN Test name"
}
]
}
]
}Get the list of voice routing policies
The following endpoint gives the list of existing voice routing policies for the owner group of the given reseller.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/voice_routing/voice_routing_policies
Authorization
Required role
resellers.instance.configurations.voice_routing.voice_routing_policies.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller from which you want to read properties |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
search | string | Used to perform a search through all searchable properties that look like the string passed | no |
sort | string | Allows to specify one searchable property of an order to apply a sorting operation | no |
dir | string | When performing a sort operation, specifies the type. Allowed values are asc for ascending (default) or desc for descending | no |
page | integer | Used for pagination, determines the current page to be shown (defaults to 1) | no |
page_size | integer | Used for pagination, determines the maximum number of records on one page of results (defaults to 10) | no |
next | string | A token used to get the next records in the list. This token is taken back from the results of the previous call | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more voice routing policies found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No of the voice routing policies found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
voiceRoutingPolicies | array | List containing all voice routing policy objects of the group | no |
results | string | Total count of results that match your query | no |
pageSize | string | Results are not provided all at once. This parameter indicates how many results are returned per page. | no |
pages | string | Total count of result pages that are available | no |
page | string | ID of the page that is currently returned | no |
next | string | A token generated as long as there are still pages to display in the list. This token may be used in a subsequent call to get the next page. It contains all query parameter from the request so they may be omitted in subsequent call | yes |
Voice Routing Policy Object
| Parameter | Type | Description | Conditional? | Searchable? |
|---|---|---|---|---|
id | integer | Index of the voice routing policy | no | no |
name | string | Name of the voice routing policy | no | yes |
pstnUsages | array | Array of pstn usage objects connected to the voice routing policy | no | no |
Example
json
{
"page": 1,
"pageSize": 10,
"pages": 1,
"results": 1,
"voiceRoutingPolicies": [
{
"id": 7,
"name": "World-DRaaS",
"pstnUsages": [
{
"id": 8,
"name": "DRaaS-New-PSTN-Usage 3"
},
{
"id": 21,
"name": "PSTN Test name"
}
]
}
]
}Get the configuration of a reseller
List all properties that make up the reseller's configuration. Properties are made up of key / value pairs. Properties may be extended or reduced at will, knowing that a basic set of properties has to be present for application correct behaviour. For the basic set of properties that have to be set, please see this list. All property names containing password or token will be returned masked as ********.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/general
Authorization
Required role
resellers.instance.configurations.general.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to get the properties |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
keys | string | A comma seperated list of keys used to restrict the returned properties to the specified keys | no |
search | string | Used to perform a search through all searchable configurations keys of a reseller that look like the string passed | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | Properties list has been correctly returned |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No reseller found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
properties | dictionary | A dictionary returning the read properties as key / value pairs | no |
Example
json
{
"properties": {
"max_calls": 30
}
}Standard Properties
| Key | Type | Example |
|---|---|---|
| draas_example | string | Example value |
Create or modify properties in of a reseller
Use this endpoint to create or modify properties that make up the configuration of a reseller. This API is an upsert one, meaning that a non-existing property will be added and an existing one will be updated.
Request
Endpoint
POST /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/general
Authorization
Required role
resellers.instance.configurations.general.create
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to add or modify properties |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
properties | dictionary | A dictionary defining properties as key / value pairs. Non-existing keys will be added to the configuration, existing ones will be updated with the new value | yes |
Example
json
{
"properties": {
"max_calls": 30
}
}Response
Status codes
| Parameter | Description |
|---|---|
204 | The properties were successfully added or modified to the group |
400 | Error while processing the properties for the group |
500 | Uncatched error on server side |
Success
Body
N/A
Modify the configurations of a reseller
Use this endpoint to modify the configurations of a reseller of the reference user's access level.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/general
Authorization
Required role
resellers.instance.configurations.general.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to add or modify properties |
URL/Query parameters
N/A
Body
A dictionary defining properties as key / value pairs.
Example
json
{
"properties": {
"max_calls": 25
}
}Response
Status codes
| Parameter | Description |
|---|---|
204 | The properties were successfully modified |
400 | Error while processing the properties |
500 | Uncatched error on server side |
Success
Body
N/A
Remove properties from a reseller
Use this endpoint to remove properties that make up the configuration of a reseller.
Request
Endpoint
DELETE /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/general
Authorization
Required role
resellers.instance.configurations.general.delete
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller from which you want to add remove properties |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
keys | array | An array of keys to remove from the configuration | yes |
Example
json
{
"keys": [
"prop_1",
"prop_2",
"prop_x"
]
}Response
Status codes
| Parameter | Description |
|---|---|
204 | The properties were successfully removed the reseller |
400 | Error while processing the properties for the reseller |
500 | Uncatched error on server side |
Success
Body
N/A
Get the configurations branding general
List of the configurations branding general of the reference user's access level.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/branding/general
Authorization
Required role
resellers.instance.configurations.branding.general.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to get the properties |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
full | boolean | Forces to return the full configurations keys ignoring any other parameters | no |
keys | string | A comma seperated list of keys used to restrict the returned properties to the specified keys | no |
search | string | Used to perform a search through all searchable configurations keys of a reseller that look like the string passed | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | Properties has been correctly returned |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No reseller found |
500 | Uncatched error on server side |
Success
Body
A dictionary defining properties as key / value pairs.
Example
json
{}Modify the configurations branding general
Use this endpoint to modify the configurations of branding general of the reference user's access level.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/general
Authorization
Required role
resellers.instance.configurations.branding.general.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to add or modify properties |
URL/Query parameters
N/A
Body
A dictionary defining properties as key / value pairs.
Example
json
{}Response
Status codes
| Parameter | Description |
|---|---|
204 | The properties were successfully modified |
400 | Error while processing the properties |
500 | Uncatched error on server side |
Success
Body
N/A
Get the configurations of branding pages
List of the configurations of branding pages of the reference user's access level.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/branding/pages
Authorization
Required role
resellers.instance.configurations.branding.pages.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to get the properties |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
full | boolean | Forces to return the full configurations keys ignoring any other parameters | no |
keys | string | A comma seperated list of keys used to restrict the returned properties to the specified keys | no |
search | string | Used to perform a search through all searchable configurations keys of a reseller that look like the string passed | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | Properties has been correctly returned |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No reseller found |
500 | Uncatched error on server side |
Success
Body
A dictionary defining properties as key / value pairs.
Example
json
{
"reseller": {
"resellerAdmins": {
"enabled": true
},
"resellerLicenseConsumption": {
"enabled": false
},
"resellerProfile": {
"enabled": false
},
"resellerRatePlan": {
"enabled": true
},
"resellerTenants": {
"enabled": true
}
},
"subscription": {
"subscriptionNumbers": {
"tabs": {
"myNumbers": {
"enabled": true
},
"porting": {
"enabled": true
},
"releasedNumbers": {
"enabled": true
},
"reservedNumbers": {
"enabled": true
}
}
}
},
"tenant": {
"tenantAdmins": {
"enabled": true
},
"tenantOrders": {
"enabled": true
},
"tenantProfile": {
"enabled": true
},
"tenantRatePlan": {
"enabled": true
},
"tenantSubscriptions": {
"enabled": true
}
}
}Modify the configurations branding pages
Use this endpoint to modify the configurations of branding pages of the reference user's access level.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/pages
Authorization
Required role
resellers.instance.configurations.branding.pages.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to add or modify properties |
URL/Query parameters
N/A
Body
A dictionary defining properties as key / value pairs.
Example
json
{
"reseller": {
"resellerAdmins": {
"enabled": true
},
"resellerLicenseConsumption": {
"enabled": false
},
"resellerProfile": {
"enabled": false
},
"resellerRatePlan": {
"enabled": true
},
"resellerTenants": {
"enabled": true
}
},
"subscription": {
"subscriptionNumbers": {
"tabs": {
"myNumbers": {
"enabled": true
},
"porting": {
"enabled": true
},
"releasedNumbers": {
"enabled": true
},
"reservedNumbers": {
"enabled": true
}
}
}
},
"tenant": {
"tenantAdmins": {
"enabled": true
},
"tenantOrders": {
"enabled": true
},
"tenantProfile": {
"enabled": true
},
"tenantRatePlan": {
"enabled": true
},
"tenantSubscriptions": {
"enabled": true
}
}
}Response
Status codes
| Parameter | Description |
|---|---|
204 | The properties were successfully modified |
400 | Error while processing the properties |
500 | Uncatched error on server side |
Success
Body
N/A
Get the configurations of branding styling
List of the configurations of branding styling of the reference user's access level.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/branding/styling
Authorization
Required role
resellers.instance.configurations.branding.pages.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to get the properties |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
full | boolean | Forces to return the full configurations keys ignoring any other parameters | no |
keys | string | A comma seperated list of keys used to restrict the returned properties to the specified keys | no |
search | string | Used to perform a search through all searchable configurations keys of a reseller that look like the string passed | no |
type | string | The type of styling asset. Possible values are:
| yes |
Response
Status codes
| Parameter | Description |
|---|---|
200 | Properties has been correctly returned |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No reseller found |
500 | Uncatched error on server side |
Success
Body
A dictionary defining properties as key / value pairs.
Example type=font
json
{
"allowed": [
"Avenir Next Cyr",
"Roboto",
"Ubuntu",
"Montserrat"
],
"name": "Avenir Next Cyr"
}Example type=image
json
{
"favicon": "/branding/default/favicon/favicon.ico",
"login": {
"bg": "/branding/default/img/Loginbackground.png",
"logo": "/branding/default/img/LoginLogo.svg"
},
"main": {
"bg": "/branding/default/img/MainBackground.png",
"logo": "/branding/default/img/Logo.svg"
}
}Example type=theme
json
{
"allowed": [
"blue",
"red",
"green"
],
"selected": "blue",
"themes": {
"blue": "/branding/default/theme.blue.json",
"green": "/branding/default/theme.green.json",
"red": "/branding/default/theme.red.json"
}
}Modify the configurations branding styling
Use this endpoint to modify the configurations of branding styling of the reference user's access level.
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/resellers/{uuid}/configurations/pages
Authorization
Required role
resellers.instance.configurations.branding.pages.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller for which you want to add or modify properties |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
type | string | The type of styling asset. Possible values are:
| yes |
And a dictionary defining properties as key / value pairs.
Example type=font
json
{
"type": "font",
"allowed": [
"Avenir Next Cyr",
"Roboto",
"Ubuntu",
"Montserrat"
],
"name": "Avenir Next Cyr"
}Example type=image
json
{
"type": "image",
"favicon": "/branding/default/favicon/favicon.ico",
"login": {
"bg": "/branding/default/img/Loginbackground.png",
"logo": "/branding/default/img/LoginLogo.svg"
},
"main": {
"bg": "/branding/default/img/MainBackground.png",
"logo": "/branding/default/img/Logo.svg"
}
}Example type=theme
json
{
"type": "theme",
"allowed": [
"blue",
"red",
"green"
],
"selected": "red",
"themes": {
"blue": "/branding/default/theme.blue.json",
"green": "/branding/default/theme.green.json",
"red": "/branding/default/theme.red.json"
}
}Response
Status codes
| Parameter | Description |
|---|---|
204 | The properties were successfully modified |
400 | Error while processing the properties |
500 | Uncatched error on server side |
Success
Body
N/A