Accounts
Information about Account Administration in Avaya Experience Platform™.
Overview
Accounts API provides access to Account Management via a REST API interface. It enables secure sharing of a single Software deployment across multiple Customers.
Before You Begin
Refer to How to Authenticate with Avaya Experience Platform™ APIs required to invoke User APIs.
Accounts APIs requires Account Administrator role for access.
Get Account
An account is an entity with specific privileges to the software.
- Unique Account ID - An account has a unique generated ID used across the entire solution.
- Flexible Organization Structure
- Account specific org structure.
- Organization node levels and their names are determined by accounts.
- Organization nodes don’t have a preconceived purpose. They provide visual cues to an administrator for easier administration of Users via Features and Roles.
- Organization structures are fluid and change with reorganization of enterprises, mergers, change in line of business, etc.
- Integration with Authorization Service
- Each Account provides clear separation of Users, Identity Providers, Roles and Permissions, Password and Session Policies, etc.
- Organization structure of an Account maps to a similar Group based structure at Authorization Service DB
To fetch a Account, user needs a Administrator privileges.
- Provide basic account details like a unique id
To get a Account you should invoke Get Account. This API requires the Administrator role.
- Account GET API returns the response as Ok with account details.
GET /accounts/{accountId}
/v1/accounts/AQWSDE
Path param:
accountId
is a unique generated ID used across the entire solution
HTTP 200 Ok
{
"name": "SyncG",
"isDefault": false,
"description": "Account for SyncG",
"domains": [
{
"domainName": "avaya.com",
"isDefault": true
}
],
"accountSize": 10,
"accountId": "AQWSDE",
"enabled": true,
"countryCode": "IN"
}
Update Account
To update an existing Account you should invoke Update Account. This API requires either the Account Administrator role.
-
[Account Administrator]
Account Administrator does not have access to either account features or feature data except for the features for which it has explicitly given the permissions. -
Account Update API returns the response as Accepted.
PUT /accounts/{accountId}
/v1/accounts/AQWSDE
Request Body:
{
"name": "SyncG",
"isDefault": false,
"description": "Account for SyncG",
"domains": [
{
"domainName": "avaya.com",
"isDefault": true
}
],
"accountSize": 10,
"accountId": "AQWSDE",
"enabled": true,
"countryCode": "IN",
"features": {
"voice": {
"cloudSwitchAccountDID": "cloudSwitchAccountDIDId",
"cloudSwitchAccountUCID": "cloudSwitchAccountUCIDId",
"voiceProvider": "UCCC",
"deleteVoiceProviderData": true,
"consult": true
}
},
"profiles": [
{
"profileId": "AQXSWF",
"url": "/api/admin/user/v1/accounts/AVSDER/profiles/ASEDFG"
}
]
}
After the Account has been created you will receive the updated Account details in the response.
HTTP 202 Accepted
{
"name": "SyncG",
"isDefault": false,
"description": "Account for SyncG",
"domains": [
{
"domainName": "avaya.com",
"isDefault": true
}
],
"accountSize": 10,
"accountId": "AQWSDE",
"enabled": true,
"countryCode": "IN",
"features": {
"voice": {
"cloudSwitchAccountDID": "cloudSwitchAccountDIDId",
"cloudSwitchAccountUCID": "cloudSwitchAccountUCIDId",
"voiceProvider": "UCCC",
"deleteVoiceProviderData": true,
"consult": true
}
},
"profiles": [
{
"profileId": "AQXSWF",
"url": "/api/admin/user/v1/accounts/AVSDER/profiles/ASEDFG"
}
]
}
Status Changes
The status on the List Account Statuses for this Account would go through the following changes:
1. Update In-Progress
[
{
"action": "UPDATE",
"status": "IN_PROGRESS",
"message": "Operation is in progress",
"accountId": "AQWSDE",
"features": {
"voice": {
"action": "ADD",
"status": "IN_PROGRESS",
"message": "Operation is in progress"
}
}
}
]
2. Update Completed
[
{
"action": "UPDATE",
"status": "COMPLETED",
"message": "Completed successfully",
"accountId": "AQWSDE",
"features": {
"voice": {
"action": "ADD",
"status": "COMPLETED",
"message": "Feature added successfully"
}
}
}
]
In the event of a failure the status would appear similar to the below.
- A client should re-attempt any failed
features
using the Update Account.
Update Failed
[
{
"action": "UPDATE",
"status": "FAILED",
"message": "Operation failed",
"accountId": "AQWSDE",
"features": {
"voice": {
"action": "ADD",
"status": "FAILED",
"message": "The feature could not be added"
}
}
}
]
Create an Organization Node
Organization Node represents a node in the Account/Organization's hierarchy. Creating a new organization node at a position in the hierarchy is determined by the value of the 'path' field.
- Provide basic Organization Node details like name, parentPath. Parent path is the fully qualified name of this node's parent node.
- Provide the AccountId of the Account.
- An Organization Node can be associated with one or more Profiles which are group of features, provided for easier management.
To create an organization node you should invoke Create Organization Node. This API requires the Account Administrator role.
- Add Organization Node API returns the response as OK. The url field returned in the response shall be used to query the Organization Node.
POST /accounts/{accountId}/organization-nodes
/v1/accounts/AQWSDE/organization-nodes
Request Body:
{
"name": "PuneLocation",
"parentPath": "AccountA",
"countryCode": "IN"
}
After the Organization Node is added, you will receive the response with created OrganizationNode data.
HTTP 202 ACCEPTED
{
"name": "PuneLocation",
"parentPath": "AccountA",
"organizationNodeId": "ACDSFE",
"url": "/api/admin/account/v1/accounts/accountA-id/organization-nodes/accountA-location1-id",
"nodeType": "OrganizationNode",
"countryCode": "IN"
}
Status Changes
The status on the List OrganizationNode Statuses for this Account would go through the following changes:
1. Add In-Progress
[
{
"action": "ADD",
"status": "IN_PROGRESS",
"message": "Operation is in progress",
"organizationNodeId": "ACDSFE"
}
]
2. Add Completed
[
{
"action": "ADD",
"status": "COMPLETED",
"message": "Completed successfully",
"organizationNodeId": "ACDSFE"
}
]
In the event of a failure the status would appear similar to the below.
- A client should re-attempt using the Update OrganizationNode.
Add Failed
[
{
"action": "ADD",
"status": "FAILED",
"message": "Operation failed",
"organizationNodeId": "ACDSFE"
}
]
Get an Organization Node
To get an organization node you should invoke Get Organization Node. This API requires the Account Administrator role.
- Get Organization Node API returns the response as OK with the OrganizationNode data.
GET /accounts/{accountId}/organization-nodes/{organizationNodeId}
/v1/accounts/AQWSDE/organization-nodes/ACDSFE
You will receive the response with OrganizationNode data.
HTTP 200 OK
{
"name": "PuneLocation",
"parentPath": "AccountSyncG",
"organizationNodeId": "ACDSFE",
"url": "/api/admin/account/v1/accounts/AQWSDE/organization-nodes/ACDSFE",
"children": [],
"profiles": [{
"profileId": "N3ZW63",
"url": "/api/admin/user/v1alpha/accounts/AQWSDE/profiles/N3ZW63",
"name": "profileVoice"
}],
"accountId": "AQWSDE",
"nodeType": "OrganizationNode"
}
Update an Organization Node
To update an organization node you should invoke Update Organization Node. This API requires the Account Administrator role.
- Update Organization Node API returns the response as OK with the updated OrganizationNode data. The url field returned in the response shall be used to query the Organization Node.
PUT /accounts/accountId/organization-nodes/organizationNodeId
/v1/accounts/AQWSDE/organization-nodes/ACDSFE
Request Body:
{
"name": "PuneLocation",
"parentPath": "AccountSyncG",
"organizationNodeId": "ACDSFE",
"url": "/api/admin/account/v1/accounts/AQWSDE/organization-nodes/ACDSFE",
"nodeType": "OrganizationNode",
"countryCode": "IN",
"profiles": [{
"profileId": "N3ZW63",
"name": "profileVoice"
}]
}
After the Organization Node is updated, you will receive the response with updated OrganizationNode data.
HTTP 200 OK
{
"name": "PuneLocation",
"parentPath": "AccountSyncG",
"organizationNodeId": "ACDSFE",
"url": "/api/admin/account/v1/accounts/AQWSDE/organization-nodes/ACDSFE",
"children": [],
"profiles": [{
"profileId": "N3ZW63",
"url": "/api/admin/user/v1alpha/accounts/AQWSDE/profiles/N3ZW63",
"name": "profileVoice"
}],
"accountId": "AQWSDE",
"nodeType": "OrganizationNode"
}
Updated 3 months ago