Use the following APIs to create, view, update, and delete an organization.

Create an Organization

Required Permissions

You must have the Create Organization permission to perform this operation.

API
/api/organizations
Method
POST
Required Parameters
Name Description
name

string

Organization name.
parentId

string

Immediate parent in the organization hierarchy.
status

string

  • INACTIVE
  • ACTIVE
domainName

string

Enter a unique identifier name to identify your organization with. If you are a part of multiple organizations, use this identifier when signing in so that VMware Pulse IoT center associates you with the correct organization.
Input Example 
	
{
 "name": "",
 "parentId":"",
 "status":"",
 "domainName":""
}
Response 
{
  "id": "string"
}

Get a List of Organizations

Required Permissions

You must have the View Organization permission to perform this operation.

API
/api/organizations
Method
GET
Required Parameters
None.
Response 
{
  "tenants": [
    {
      "id": "",
      "name": "",
      "parentId": "",
      "status": "",
      "domainName":"",
      "createdTime": "",
      "lastUpdatedTime": "",
      "updateVersion": 1
    }
  ],
  "pageInfo": {
    "page": 1,
    "pageSize": 10,
    "totalElements": "11",
    "totalPages": "2"
  }
}

Get an Organization by ID

Required Permissions

You must have the View Organization permission to perform this operation.

API
/api/organizations/{id}
Method
GET
Required Parameters
Name Description
id

string

Organization ID.
domainName

string

Enter a unique identifier name to identify your organization with. If you are a part of multiple organizations, use this identifier when signing in so that VMware Pulse IoT center associates you with the correct organization.
Response 
{
 "id":"",
 "name": "",
 "parentId":"",
 "status":"",
 "domainName":"",
 "createdTime": "",
 "lastUpdatedTime": "",
 "updateVersion":1,
 "orgId":"",
 "createdBy":"",
 "lastUpdatedBy":""
}

Update an Organization

Required Permissions

You must have the Edit Organization permission to perform this operation.

API
/api/organizations/{id}
Method
PUT
Required Parameters
Name Description
name

string

Organization name.
parentId

string

Immediate parent in the organization hierarchy.
status

string

  • INACTIVE
  • ACTIVE
domainName

string

Enter a unique identifier name to identify your organization with. If you are a part of multiple organizations, use this identifier when signing in so that VMware Pulse IoT center associates you with the correct organization.
Input Example 
	
{
 "name": "",
 "parentId":"",
 "status":"",
 "domainName":"",
 "updateVersion":1,
}
Response 
{
  "id": "string"
}

Delete a Organization

Required Permissions

You must have the Delete Organization permission to perform this operation.

API
/api/organizations/{id}
Method
DELETE
Required Parameters
Name Description
id

string

Organization ID.
Response 
{}