ATataccama
Groups

Create group

Create a group under an existing parent group.

post/iam/v1/groups

Request

Request body

parentUrnstring uri required

A URN identifying a group resource in the IAM API.

To find a group's URN, use the Groups endpoints of the IAM API.

Format: urn:ata:{tenant}:iam:group:{uuid}

Example: urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000.

namestring required

Name of the group.

descriptionstring

Human-readable description of the group's purpose.

Example request

{
  "parentUrn": "urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000",
  "name": "Data Governance",
  "description": "Group responsible for data governance across the organization."
}

Response

The created group.

urnstring uri required

A URN identifying a group resource in the IAM API.

To find a group's URN, use the Groups endpoints of the IAM API.

Format: urn:ata:{tenant}:iam:group:{uuid}

Example: urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000.

parentUrnstring uri

A URN identifying a group resource in the IAM API.

To find a group's URN, use the Groups endpoints of the IAM API.

Format: urn:ata:{tenant}:iam:group:{uuid}

Example: urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000.

namestring required

Name of the group.

descriptionstring

Human-readable description of the group's purpose.

Example response

{
  "urn": "urn:ata:acme-corp:iam:group:8e1f3a5c-9b2d-4c7e-a6f0-1d2e3c4b5a69",
  "parentUrn": "urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000",
  "name": "Data Governance",
  "description": "Group responsible for data governance across the organization."
}

Changes

No recorded changes to this operation across all 1 revision of this API.