Overview
Group templates must be created with the Cortado MDM in order to be accessed via the API.
Recommended:To authenticate use the api key, obtained as described here, on every request as the authorization header like this: Authorization: Api-Key my_api_key
To execute requests in a user context use the access token, obtained as described here, on the request as the json field token.
All additional request parameters are also added as json fields to the request body. The request content type must be application/json.
Using the Accept-Language request header the response localization can be set. Default is "en" for english, possible other value is "de" for german
Base API URL: https://go.mycortado.com/api/mdm/v2/group
Example Request
POST /api/mdm/v2/group/example HTTP/1.1
Host: go.mycortado.com
Content-Type: application/json
Authorization: Api-Key my_api_key
{
... all request parameters ...
}
Example Response
HTTP Status | Description |
---|---|
200 | Request successfull. The response body will contain optional group template data. |
401 | Authentication has failed. The access token was not passed or is invalid. You need to refresh the access token first. |
403 | Action forbidden. For example when a user access token is send in the request that is only usable with an admin access token. |
Group Fields
The following fields can be returned by the API containing information about the user.
Field | Description |
---|---|
description | the description of the group template |
id | the id of the group template |
name | the name of the group template |
priority | the priority of the group template |
sid | the sid of the group template |
Get Group Templates
This request can only be used by sending an admin access token.
By sending such a token informations about all group templates of the admin access tokens tenant can be retrieved.
Get Group Templates Request
Parameters
POST /api/mdm/v2/group/list HTTP/1.1
Host: go.mycortado.com
Content-Type: application/json
Authorization: Api-Key my_api_key
{
}
Get Group Templates Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"errorcode": null,
"errormessage": null,
"success": true,
"tokenstatus": null,
"data": [
{
"description": "This template is used for ccs users that are not in a managed active directory group.",
"id": 1,
"name": "Default Group Template",
"priority": 0,
"sid": "default_user_template"
},
{
"description": "Description",
"id": 2,
"name": "Test 1",
"priority": 1,
"sid": "b966e92c-13c6-4bb5-afc2-dbb2a079e697"
},
{
"description": "",
"id": 3,
"name": "Test 2",
"priority": 2,
"sid": "49e962f0-d188-4100-9d68-43d6191157f3"
}
],
"pagecount": 1,
"pageindex": 1,
"totalcount": 3
}