Skip to main content

Create an Organizational Unit​

Create a new organizational unit. Adding entities to the OU is an asynchronous operation and has a task associated. When the request has entities to be added, the response has a task ID which can be used to track the progress of the operation.

Query Parameters
  • embed string

    Embeds the details of each associated resource. Set the parameter to one of the following embeddable links to include additional details associated with the resource.

    Embeddable LinkDescription
    read-taskEmbeds the associated task in the response. For example, ?embed=read-task
    For more information about embedded links, refer to the Embedding Referenced Resources section of this guide.
Request Body
  • description string

    Possible values: <= 129 characters

    A description of the organizational unit.

  • entities object[]

    List of entities to add to the organizational unit. Adding entities to the OU is an asynchronous operation. The response will has a task ID, which can be used to track the progress of the operation.

  • parent_entity object

    The parent object of the primary entity associated with the organizational unit. The parent object is optional and can be omitted.

  • id string

    The Clumio assigned ID of the entity.

  • type string

    Possible values: [aws_environment, microsoft365_domain, azure_ad_domain]

    The entity type.

  • primary_entity object

    The primary object associated with the organizational unit. Examples of primary entities include "aws_environment".

  • id string

    The Clumio assigned ID of the entity.

  • type string

    Possible values: [aws_environment, microsoft365_domain, azure_ad_domain]

    The entity type.

  • name string required

    Possible values: non-empty and <= 129 characters

    Unique name assigned to the organizational unit.

  • parent_id uuid4

    The Clumio-assigned ID of the parent organizational unit under which the new organizational unit is to be created. If absent, the new organizational unit is created under the current organizational unit.

  • users object[]

    List of user IDs, with role, to assign this organizational unit.

  • assigned_role uuid4

    The Clumio-assigned ID of the role to be assigned to the user.

  • user_id string

    The ID of the user.

Responses

Created

Schema
  • _links object

    URLs to pages related to the resource.

  • _self object

    The HATEOAS link to this resource.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • delete-organizational-unit object

    A resource-specific HATEOAS link.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • patch-organizational-unit object

    A resource-specific HATEOAS link.

  • href string

    The URI for the referenced operation.

  • templated boolean

    Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.

  • type string

    The HTTP method to be used with the "href" link for the referenced operation.

  • children_count int64

    Number of immediate children of the organizational unit.

  • configured_datasource_types string[]

    Datasource types configured in this organizational unit. Possible values include aws, microsoft365, vmware, or mssql.

  • descendant_ids string[]

    List of all recursive descendant organizational units of this OU.

  • description string

    A description of the organizational unit.

  • id string

    The Clumio assigned ID of the organizational unit.

  • name string

    Unique name assigned to the organizational unit.

  • parent_id string

    The Clumio assigned ID of the parent organizational unit. The parent organizational unit contains the entities in this organizational unit and can update this organizational unit. If this organizational unit is the global organizational unit, then this field has a value of null.

  • user_count int64

    Number of users to whom this organizational unit or any of its descendants have been assigned.

  • users object[]

    Users IDs to whom the organizational unit has been assigned. This attribute will be available when reading a single OU and not when listing OUs.

  • assigned_role uuid4

    The Clumio-assigned ID of the role to be assigned to the user.

  • user_id string

    The ID of the user.

POST /organizational-units

Authorization

Request

Click Edit to configure Base URL
https://us-west-2.api.clumio.com
Bearer Token
embed — query
Body
{

  "description": "string",

  "entities": [

    {

      "parent_entity": {

        "id": "string",

        "type": "aws_environment"

      },

      "primary_entity": {

        "id": "string",

        "type": "aws_environment"

      }

    }

  ],

  "name": "string",

  "parent_id": "string",

  "users": [

    {

      "assigned_role": "string",

      "user_id": "string"

    }

  ]

}
Accept
curl -L -X POST 'https://us-west-2.api.clumio.com/organizational-units' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.organizational-units=v2+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "description": "string",
  "entities": [
    {
      "parent_entity": {
        "id": "string",
        "type": "aws_environment"
      },
      "primary_entity": {
        "id": "string",
        "type": "aws_environment"
      }
    }
  ],
  "name": "string",
  "parent_id": "string",
  "users": [
    {
      "assigned_role": "string",
      "user_id": "string"
    }
  ]
}'