Create Org

Create Org

Create a new organization. If the API version is 40 or above, the operation is asynchronous and a task is returned in the location header. Otherwise, the operation is synchronous.

Request
URI
POST
https://{api_host}/cloudapi/1.0.0/orgs
COPY
Request Body
Org of type(s) application/json
Optional

Show optional properties

{
    "name": "string",
    "displayName": "string"
}
{
    "id": "string",
    "name": "string",
    "displayName": "string",
    "description": "string",
    "isEnabled": false,
    "managedBy": {
        "name": "string",
        "id": "string"
    },
    "canManageOrgs": false,
    "maskedEventTaskUsername": "string",
    "directlyManagedOrgCount": 0,
    "isClassicTenant": false,
    "isProviderConsumptionOrg": false,
    "creationStatus": "string"
}
Authentication
This operation uses the following authentication methods.
Responses
201

Created

Returns Org of type(s) application/json;version=40.0 
"Org Object"
string
id
Optional

A unique identifier for the organization.

string As ^[a-zA-Z0-9_\-\.\!\'\(\),\$]+$
name
Required
Constraints: maxLength: 128

Name of the organization.

string As (?=.*\S.*)^[^\p{Zl}\p{Zp}\p{C}]*$
displayName
Required
Constraints: maxLength: 128

Full display name of the organization.

string
description
Optional
Constraints: maxLength: 256 default:

Description of the organization.

boolean
isEnabled
Optional

Whether the organization is enabled or not.

object
managedBy
Optional

Entity reference used to describe VCD entities

boolean
canManageOrgs
Optional

Whether or not this org can manage other tenant orgs. This can be toggled to true to automatically perform the following steps:

  • Publishes the Default Sub-Provider Entitlement Rights Bundle to the org
  • Publishes the Sub-Provider Administrator global role (if it exists) to the org
  • Creates a Default Rights Bundle in the org containing all publishable rights that are currently published to the org. Marks that Rights Bundle as publish all.
  • Clones all default roles currently published to the org into Global Roles in the org. Marks them all publish all.
Cannot be set to false as there may be any number of Rights Bundles granting sub-provider rights to this org. Instead, unpublish any rights bundles that have the Org Traverse right from this org.
string
maskedEventTaskUsername
Optional
Constraints: maxLength: 256 default: system

Masked username as it appears in the tenant events/tasks. Requires "Organization Edit Username Mask".

integer
directlyManagedOrgCount
Optional

The count of the orgs this org directly manages.

boolean
isClassicTenant
Optional

Whether the organization is a legacy VRA-style tenant. This field cannot be updated. Note this style is deprecated and this field exists for the purpose of VRA backwards compatibility.

boolean
isProviderConsumptionOrg
Optional

Indicates if this org is a provider consumption org.

string
creationStatus
Optional

The creation status of the Organization. This is a read only field. Possible values are READY, NOT_READY, ERROR, FAILED_CREATION, and CONFLICT.


202

The request have been accepted and the task to monitor the request is in the Location header.

Operation doesn't return any data structure

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"displayName:"string","name:"string"}' https://{api_host}/cloudapi/1.0.0/orgs
Availability
Added in 36.0
On This Page
Org Operations
GET
Query Orgs
POST
Create Org
GET
Get Org
PUT
Update Org
DELETE
Delete Org