public
Group

Create a group in an organization

Changed on
post/orgs/{orgId}/groups

Request

  • Base URL
    https://api.humanitec.io
  • URL
    https://api.humanitec.io/orgs/{orgId}/groups
  • Auth
    none declared

Path parameters

orgIdstring required

The Organization ID

Request body

group_idstring required

The name of the group in the IdP.

idp_idstring required

The IdP id.

role'administrator' | 'manager' | 'member' | 'artefactContributor' | 'orgViewer' required

Roles that can be assumed by an entity on an organization.

Example request

{
  "group_id": "my-idp-group",
  "idp_id": "my-idp",
  "role": "manager"
}

Response

Group created with the specified Organization Role.

idstring required

The id used in Humanitec to identify the group.

group_idstring required

The name of the group in the IdP

idp_idstring required

The IdP id.

role'administrator' | 'manager' | 'member' | 'artefactContributor' | 'orgViewer' required

Roles that can be assumed by an entity on an organization.

created_atstring date-time

The time the user was first registered with Humanitec

Example response

{
  "id": "g-d510224a-4641-48fd-8054-68efd3537ee2",
  "group_id": "my-idp-group",
  "idp_id": "my-idp",
  "role": "manager"
}

Changes