Submit group hierarchy relationships

PUT

/v1/directory/group-hierarchy-relationship

Submit group relationships for group hierarchy calculation in directory management.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "groupRelationships": [
        {
            "group": "Channel Marketing",
            "groupType": "Department",
            "parent": "Marketing",
            "parentType": "Division"
        },
        {
            "group": "Marketing",
            "groupType": "Division",
            "parent": null,
            "parentType": null
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.calven.com/v1/directory/group-hierarchy-relationship' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "groupRelationships": [
        {
            "group": "Channel Marketing",
            "groupType": "Department",
            "parent": "Marketing",
            "parentType": "Division"
        },
        {
            "group": "Marketing",
            "groupType": "Division",
            "parent": null,
            "parentType": null
        }
    ]
}'

Responses

🟢204

This response does not have a body.

🟠401

Modified at 2026-04-30 15:23:20

Org Hierarchy Information Overview

Submit group hierarchy relationships with Basic Auth