Cognite Data Fusion API

Create groups

Creates one or more named groups, each with a set of capabilities. All users with any group membership in a CDF project automatically get the userProfilesAcl:READ capability and can search for other users. If not assigned automatically, user profiles must be enabled for the project. To enable user profiles, contact support.

Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code

Request

Request Body schema: application/json
required

List of groups to create.

required

Array of managedExternally (object) or managedInCDF (object) (GroupSpec)

Responses

201

A list of the created groups.

400

Missing required fields.

post/groups

Request samples

Payload
JavaScript SDK
Python SDK
curl

application/json

{"items": [{"name": "Production Engineers",
"capabilities": [{"agentsAcl": {"actions": ["READ"
],
"scope": {"all": { }
}
},
"projectUrlNames": {"urlNames": ["publicdata"
]
}
}
],
"metadata": {"property1": "string",
"property2": "string"
},
"attributes": {"token": {"appIds": ["string"
]
}
},
"sourceId": "b7c9a5a4-99c2-4785-bed3-5e6ad9a78603"
}
]
}

Response samples

application/json

{"items": [{"name": "Production Engineers",
"capabilities": [{"agentsAcl": {"actions": ["READ"
],
"scope": {"all": { }
}
},
"projectUrlNames": {"urlNames": ["publicdata"
]
}
}
],
"metadata": {"property1": "string",
"property2": "string"
},
"attributes": {"token": {"appIds": ["string"
]
}
},
"sourceId": "b7c9a5a4-99c2-4785-bed3-5e6ad9a78603",
"id": 0,
"isDeleted": false,
"deletedTime": 0
}
]
}

➔ Next to Delete groups

Create groups

Request Body schema: application/jsonrequired

Request Body schema: application/json
required