Update assigned tariff | emnify Documentation

Allows an organisation to change their assigned tariff.

The following restrictions apply:

The organisation must not have more than one tariff assigned.
The tariff can be changed only for the own organisation and direct child organisations. The organisation status must be “ACTIVE”.
If performing the change in self-service, the organisation needs to be in evaluation. Parent organisations are allowed to change the tariffs of production organisations.
The selected tariff must be active, visible to the requested organisation and must have the same currency. Parent organisations are allowed to assign private tariffs to their child organisations.

In addition to updating the assigned tariff, the system will also:

Update all of the organisations tariff profiles to use the new tariff.
Activate all ratezones in the tariff in order to ensure that the endpoints do not lose connection.
Expire all currently active inclusive volumes and custom rates and delete future ones.

Allows an organisation to change their assigned tariff. The following restrictions apply: * The organisation must not have more than one tariff assigned. * The tariff can be changed only for the own organisation and direct child organisations. The organisation status must be "ACTIVE". * If performing the change in self-service, the organisation needs to be in evaluation. Parent organisations are allowed to change the tariffs of production organisations. * The selected tariff must be active, visible to the requested organisation and must have the same currency. Parent organisations are allowed to assign private tariffs to their child organisations. In addition to updating the assigned tariff, the system will also: * Update all of the organisations tariff profiles to use the new tariff. * Activate all ratezones in the tariff in order to ensure that the endpoints do not lose connection. * Expire all currently active inclusive volumes and custom rates and delete future ones.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Path parameters

org_idintegerRequired

Numerical ID of an organization

Request

This endpoint expects an object.

iddoubleRequired

ID of the new tariff

Response

Response to a successful GET, also used for a POST if it does not result in a creation

Errors

Allows an organisation to change their assigned tariff.

The following restrictions apply:

The organisation must not have more than one tariff assigned.
The tariff can be changed only for the own organisation and direct child organisations. The organisation status must be “ACTIVE”.
If performing the change in self-service, the organisation needs to be in evaluation. Parent organisations are allowed to change the tariffs of production organisations.
The selected tariff must be active, visible to the requested organisation and must have the same currency. Parent organisations are allowed to assign private tariffs to their child organisations.

In addition to updating the assigned tariff, the system will also:

Update all of the organisations tariff profiles to use the new tariff.
Activate all ratezones in the tariff in order to ensure that the endpoints do not lose connection.
Expire all currently active inclusive volumes and custom rates and delete future ones.

1	import requests
2
3	url = "https://cdn.emnify.net/api/v1/organisation/1/tariff"
4
5	payload = { "id": 1 }
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.patch(url, json=payload, headers=headers)
12
13	print(response.json())