Events

The Events resource represents the Passbridge event stream. The event stream current exposes data control events such as device quota overages and cut-offs.

APIDescription
GET v1/integration/events?count={count}

Get a list of events for this integration from Passbridge

DELETE v1/integration/events/{eventid}

Delete an event for this integration from Passbridge

Integration

The Integration resource represents the collection of resources related to an integration with a given partner. Integrations are provisioned out of band by Asavie in collaboration with a partner.
All ApiAccount created by a partner are stored within the Integration. Each Product defined for an Integration are also stored within the Integration.

APIDescription
GET v1/integration/accounts

Returns all the ApiAccount with the Integration

GET v1/integration/products

Returns a list of the valid products for the current Integration. A product represents a specific configuration of and Asavie network along with any parameters that are required to do the configuration. Depending on requirement Asavie can create custom Products for an Integration that have all the required defaults in place so that no parameters are required to be passed in

AccountNetwork

The AccountNetwork resource represents a single Asavie software defined network within an ApiAcccount. An Asavie network represents a single data controlled private network that can have its member devices' traffic routed to Agents or the internet. This is the core entity within the Asavie cloud.
The AccountNetwork needs to be given a unique name within the ApiAccount

APIDescription
GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/product/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall/upstream/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall/downstream/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks

Get all the AccountNetworks in the Account.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}

Get the AccountNetwork.

POST v1/accounts/{foreignaccountkey}/networks

Create a new AccountNetwork in the ApiAccount. Each AccountNetwork must have a unique foreignkey, otherwise a failure result with a 409 error code is returned.

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}

Update the AccountNetwork. A typical use is to set the user name for the Asavie Network. This is especially important in the context of the Moda application which require Asavie network credentials to access it.

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}

No documentation available.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/product

Retrieve the current AccountNetwork product. The product defines the configuration and behaviour of the Asavie network.

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/product

Set the AccountNetwork product. The product defines the configuration and behaviour of the Asavie network.

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/product

Update the Product settings for an AccountNetwork. A typical use is to change one of the properties such as a quota alert

PUT v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall

Set the a firewall for the AccountNetwork. The rules are specified as standard cisco firewall format

PUT v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall/upstream

Set the upstream (from device to network) firewall for the AccountNetwork. The rules are specified as standard cisco firewall format

PUT v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall/downstream

Set the downstream (from network to device) firewall for the AccountNetwork. The rules are specified as standard cisco firewall format

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall

Get the upstream (from device to network) firewall for AccountNetwork.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall/upstream

Get the upstream (from device to network) firewall for AccountNetwork. The rules are specified as standard cisco firewall format

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/firewall/downstream

Get the downstream (from device to network) firewall for AccountNetwork. The rules are specified as standard cisco firewall format

Sim

The SIM resource represents a single hardware SIM card in an ApiAcccount. The SIM provides a mechanism to manage the SIM estate, allowing the SIM state to be changed on the radio access network. The provisioning platform has the necessary plug-ins to drive the underlying sim management apis.
The SIM is not automatically associated with and Asavie network. It is up to the API user to create and manage APN devices for the corresponding SIM. Once the SIM has a corresponding APN device on an AccoutNetwork than that SIM can take advantage of all the features of the Asavie Cloud

APIDescription
GET v1/accounts/{foreignaccountkey}/hardware/sims/{rawcli}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/hardware/sims/{rawcli}/action/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/hardware/sims

Returns all the SIMs for an Api Account

GET v1/accounts/{foreignaccountkey}/hardware/sims/{rawcli}

Returns a SIM for an Api Account

POST v1/accounts/{foreignaccountkey}/hardware/sims/{rawcli}/action

Allow actions to be submitted for a SIM. The only supported action here is a 'sendpacketofdisconnect' action. That will request a that the device be diconnected for the radio netowrk. (Note: this is only available on certain integrations

POST v1/accounts/{foreignaccountkey}/hardware/sims

Create a new SIM on the ApiAccount. Each SIM must have a unique CLI, otherwise a failure result with a 409 error code is returned.

PATCH v1/accounts/{foreignaccountkey}/hardware/sims/{rawcli}

Update a SIM device on the ApiAccount. This is primarily used to changes the SIM's state on the radio network.

DELETE v1/accounts/{foreignaccountkey}/hardware/sims/{rawcli}

Deletes a SIM from the Api Account

Account

The Account resource respresents a single Api Account. There is one Account per logical customer on the api user's side. The key property is the 'ForeignAccountKey'. This links this Account to the api user's account on their side. It may for example be the Salesforce Id of one of their customers for which they want to provide Asavie services to.

An Account is a container for 1 or more Asavie Networks. An Asavie Network represents a single security context, one logical network. Devices cannot interact between 2 networks and can only belong 1 network.

APIDescription
GET v1/accounts/{foreignaccountkey}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts

Returns all the ApiAccount with the Integration

GET v1/accounts/{foreignaccountkey}

Get the Api Account for the foreignaccountkey supplied

POST v1/accounts

Create a new Api Account. Each account must have a unique ForeignAccountKey, otherwise a failure result with a 409 error code is returned.

PATCH v1/accounts/{foreignaccountkey}

Update the Account. Primarily for updating the ForeignAttributes which may be required by the backend plugins to drive 3rd party apis such as GDSP, SalesForce etc.

DELETE v1/accounts/{foreignaccountkey}

Delete the Account. This action is irreversible!

Logs

APIDescription
GET v1/accounts/{foreignaccountkey}/logs?actorKey={actorKey}&actorType={actorType}&src={src}

Returns the logs for a given account, actor type and key.

Agents

The Agent resource represents a single software vCPE (virtual Consumer Premises Equipment) on an Asavie network. An agent a critical component for any Asavie network that provides connectivity to a user's LAN. An Asavie network can has 1 or more Agents.
If the Asavie network is just providing controlled internet access then an Agent is not required as the connectivity is supplied via the Asavie Cloud.

APIDescription
POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents/action

Allow actions to be submitted for all Agents. The only supported action here is a 'refresh' action. That will request a refresh of all agents connection statuses

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents/{agentid}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents/{agentid}/action/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents/action/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents?refresh={refresh}

Returns all the Agents for a particular network on the Account

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents/{agentid}?refresh={refresh}

Returns an Agent for a particular network on the Account

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents/{agentid}/action

Allow actions to be submitted for an Agent. The only supported action here is a 'refresh' action. That will request a refresh of the agent connection status

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents

Create a new Agent on the network. Each Agent must have a unique AgentName, otherwise a failure result with a 409 error code is returned.

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents/{agentid}

Update the Agent. A typical use here is to enable of disable the Agent. Disabling the Agent stops all traffic from the Asavie Cloud flowing into the user's LAN.

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/agents/{agentid}

Delete the Agent

Batch

The Batch resources represents a collection of calls to the API. It allows for an arbitrary number individual calls to be grouped and tracked as a single entity.
This is primarily used to control when notifications are sent.

APIDescription
POST v1/batches

Creates a new Batch. The Batch cotains a Naame and Description as well as optional properties such as the AppTag and Parameters that allow custom data to be sent to eh Api platform backend which can then take specific actions based on that data.
The pattern to be followed is to first create a batch, send any Api commands and finally update the Batch, marking it's Status as 'defined'. The Batch status can be queried by getting the Batch based on its unique Id.

PUT v1/batches/{batchid}

Updates the Batch. This is used primarly to update the Status to 'defined'. This is used to indicate that eh contents of the batch is now complete.

GET v1/batches/{batchid}

Returns a Batch based on its unique Id.

POST v1/batches/{batchid}/actions/notifications

Create an action to be triggered on Batch completion. The only supported action currently is to trigger a notification message.

IOTDevice

The IOT device resource represents a single IP over TLS based device. Once the IOT device is registered on an Asavie network it can then connect to it and route traffic securely to an Agent on the network or route in a policy controlled fashion out to the internet (depending on the configuration of the Asavie network.
An IOT device is registered on an Asavie network by adding it to the desired network with the devices unique id (usually MAC address)

APIDescription
POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/action

Allow actions to be submitted for all IOT devices. The only supported action here is a 'refresh' action. That will request a refresh of all devices connection statuses

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/action/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}/action/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}/firewall/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}/datacontrolgroup/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}/cloudconnectorgroup/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}/cloudconnectorcredential/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots?refresh={refresh}

Returns all the IOT devices for a particular network on the Account

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}

Returns an IOT device for a particular network on the Account

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots

Create a new IOT device on the network. Each IOT device must have a unique id (usually it's MAC address), otherwise a failure result with a 409 error code is returned.

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}

Update the IOT device. A typical use here is to enable of disable the IOT device. Disabling the IOT device stops the device connecting to the Asavie cloud.

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}

Delete the IOT device.

PUT v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}/datacontrolgroup

Set the Data Control Group for this individual device. The set of groups is available via ..

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{rawcli}/cloudconnectordetails?deviceId={deviceId}

Get the CloudConnector Details

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{rawcli}/cloudconnectordetails?deviceId={deviceId}

Post the CloudConnector Details

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{rawcli}/cloudconnectordetails?deviceId={deviceId}

Update the CloudConnector Details

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{rawcli}/cloudconnectordetails?deviceId={deviceId}

Deletes the CloudConnector Details

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/iots/{deviceid}/datacontrolgroup

Get the Data Control Group name for this individual device.

APNDevice

The APN device resource represents a single sim based device with the Asavie APN configured on it. Once the APN device is registered on an Asavie network it can then connect to it and route traffic securely to an Agent on the network or route in a policy controlled fashion out to the internet (depending on the configuration of the Asavie network.
An APN device is registered on an Asavie network by adding it to the desired netowrk with a unique CLI

APIDescription
POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/action

Allow actions to be submitted for all APN devices. The only supported action here is a 'refresh' action. That will request a refresh of all devices connection statuses

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/action/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/firewall/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/datacontrolgroup/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/cloudconnectorgroup/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/cloudconnectorcredential/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/action/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns?refresh={refresh}

Returns all the APN devices for a particular network on the Account

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}?refresh={refresh}

Returns an APN device for a particular network on the Account

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/action

Allow actions to be submitted for an APN device.

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns

Create a new APN device on the network. Each APN device must have a unique CLI, otherwise a failure result with a 409 error code is returned.

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}

Update the APN device.

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}

Delete the APN device.

PUT v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/datacontrolgroup

Set the Data Control Group for this individual device. The set of groups is available via ..

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/cloudconnectordetails

Get the CloudConnector Details

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/cloudconnectordetails

Post the CloudConnector Details

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/cloudconnectordetails

Update the CloudConnector Details

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/cloudconnectordetails

Deletes the CloudConnector Details

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/devices/apns/{rawcli}/datacontrolgroup

Get the Data Control Group name for this individual device.

IntegrationLevelSubscription

APIDescription
GET v1/integration/subscriptions

Returns all the Subscriptions

POST v1/integration/subscriptions

Create a new Api Subscription.

PATCH v1/integration/subscriptions

Updates the Subscription.

DELETE v1/integration/subscriptions

Delete the Subscription. This action is irreversible!

Help

APIDescription
GET v1/authtoken/about

Returns details of the currently authenticated credentials. This can be used to verify that the correct credentials are being used

Utils

APIDescription
GET v1/version

Returns the current version of the API

Analytics

The Analytics resource represents the set of analytics data available for a given account network.
These are the list of reports available:
- clientsessions: returns the raw session data for the given time period. data can be filtered, sorted and paged. - datausage: returns the total data usage for the given time period, eventually grouped in hour, day, week, month time buckets - datausage/topdevices: returns the list of the devices with the highest (or lowest) data usage - datausage/topgroups: returns the list of the groups with the highest (or lowest) data usage - datausage/topzones: returns the list of the zones with the highest (or lowest) data usage

APIDescription
GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/analytics/clientsessions?from={from}&to={to}&timeZoneOffset={timeZoneOffset}

This resource returns the raw session data for the given time period

The properties returned can be as follows:-
DeviceName: a string with a textual name for the device the session is attached to
CLI: a string with a unique identifier for the device - e.g. its MSISDN
StartTime: the UTC time the session started
EndTime: the UTC time the session ended
SessionEndCause: the reason the session terminated - one of:AccountingStop,AdminClear,UserDisabled,UserDeleted,DeviceDisabled,DeviceDeleted,SessionExpired,NewLogin,AuthentFailed,AuthorizeRejected,ASDiscoveryFailed,AccountDisabled,AccountDeleted,QuotaCutoffExceeded
DataTx: bytes transmitted during the session
DataRx: bytes received during the session
MCC: Mobile country code the device connected from (if an APN based device and if the data is available)
MNC: Mobile carrier code the device connected over (if an APN device and if the data is available)
RestrictionCause: Indicates if a data control restriction has been placed on the device (only applicable if data controls are enabled and being used)
RestrictionTime: The time the device was restricted
DataAccessGroup: The data access group the device belongs to (only applicable if data controls are enabled)
Zone:The zone (defined by a set of MCC,MNC pairs) the device connected in (only applicable if data controls are enabled)

AccountLevelSubscription

APIDescription
GET v1/accounts/{foreignaccountkey}/subscriptions

Returns all the Subscriptions

POST v1/accounts/{foreignaccountkey}/subscriptions

Create a new Api Subscription.

PATCH v1/accounts/{foreignaccountkey}/subscriptions

/// Updates the Subscription.

DELETE v1/accounts/{foreignaccountkey}/subscriptions

Delete the Subscription. This action is irreversible!

DataControl

The Data Control resource represent all the data control features on given network. Data control for APN and IOT devices is managed on a group and Zone basis.
A group can contain 1 or more APN or IOT devices. The data control policy is specified at the group level. All mebers of the group have the policies applied to them
A zone defines a geogrpahic region that devices operate within. For APN devices a zone is defined by a list of MCC & MNC pairs. Data control policy is applied to a device based on the group it is a member of and the zone it is currently located in.

The Data Control policy for a given group and zone combination specifies
1) The quota limits - a restriction quota and a cutoff quota 2) A normal policy to be applied if the device is under the restriction quota set 3) A restriction policy to be applied if the device hits the restriction quota set

The normal and restriction policy specify
1) The data access rate to be applied 2) The ACL to be applied 3) THe Domain filtering policy to be applied

APIDescription
GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}/apnpolicies/{zonename}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/zones/apnzones/{zonename}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/domainfiltering/policies/{policyname}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups

Returns all the data access groups defined on this network

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups

Create a new data control group on the network. The group name can then be used to set membership for APNDevices by setting their DataControlGroup property

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}

Returns the data access groups defined on this network with the supplied group name

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}

Update the data control group.

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}

Delete the data control group. Note if a group has members then the delete request will return a 403 forbidden.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}/apnpolicies

Returns all the APN Policies defined on this network for this group. An APN Policy is set for each Zone defined on the network.

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}/apnpolicies

Create a new APN Policy on this network and in this group.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}/apnpolicies/{zonename}

Returns the APN Policy defined on this network for this group and specified zonename

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}/apnpolicies/{zonename}

Update the APN Policy defined on this network for this group and specified zonename

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/groups/{groupname}/apnpolicies/{zonename}

Delete the APN Policy defined on this network for this group and specified zonename

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/zones/apnzones

Returns all the APN Zones defined on this network for this group.

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/zones/apnzones

Create a new APN Zone on this network.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/zones/apnzones/{zonename}

Returns the APN Zone defined on this network with the specified zonename

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/zones/apnzones/{zonename}

Update the APN Zone defined on this network with the specified zonename

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/zones/apnzones/{zonename}

Delete the APN Zone defined on this network with the specified zonename. Note: if the Zone is in use, i.e. has a policy defined on it and is associated witha group that has members then the delete will fail/

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/domainfiltering/policies

Returns all the Domain Filtering Policies defined on this network.

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/domainfiltering/policies

Create a new Domain Filtering Policy on this network.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/domainfiltering/policies/{policyname}

Returns the Domain Filtering Policy defined on this network with the specified policy name

PATCH v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/domainfiltering/policies/{policyname}

Update the Domain Filtering Policy defined on this network with the specified policy name

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/datacontrol/domainfiltering/policies/{policyname}

Delete the Domain Filtering Policy defined on this network with the specified policy name

Routes

The Route resource represents a network route on an Asavie network. There are several types of route including:-
Static: routes added by the Api user that are particular to their network needs Blackhole: routes that are to be 'balckholed' i.e. terminated with no endpoint Rip: these are routes that are populated in by other routing deevices on the network
An Route is registered on an Asavie network by adding it to the desired network with a unique Id

APIDescription
GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/routes

Returns all the Route for a particular network on the Account

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/routes/{routeid}/status?cmdid={cmdid}

Returns the status of an API command. Any API command that returns a 202 HTTP status code also returns a status url that allows the progress of the command to be tracked.

GET v1/accounts/{foreignaccountkey}/networks/{foreignkey}/routes/{routeid}

Returns an Route for a particular network on the Account

POST v1/accounts/{foreignaccountkey}/networks/{foreignkey}/routes

Create a new Route on the network. Each Route must have a unique Id, otherwise a failure result with a 409 error code is returned.

DELETE v1/accounts/{foreignaccountkey}/networks/{foreignkey}/routes/{routeid}

Delete the Route

AccountCredentials

The Account Credentials controller represents all the credentials that have been created for the given account. It allow credentials to be created, updated, retrieved and deleted based on the callers permissions.

If the caller has an account level role they will only see credentials they created themselves integration level roles have access to all account level credentials

APIDescription
GET v1/accounts/{foreignaccountkey}/credentials

Returns all the Credentials that give access to this account. The list returned depends on the callers role.

GET v1/accounts/{foreignaccountkey}/credentials/{apiclientid}

Returns the requested credential.

POST v1/accounts/{foreignaccountkey}/credentials

Creates a new set of credentials that give access to this api account. An api secret is generated and returned as part of new credential object.
Note: POSTed Scope, ScopeRef and Integration values are ignored and set by the system,.

PATCH v1/accounts/{foreignaccountkey}/credentials/{apiclientid}

Updates an existing credential

DELETE v1/accounts/{foreignaccountkey}/credentials/{apiclientid}

Deletes a credential