Create new device group

This resource provides manipulation with the device group. 

Scheme

https

 

Host

Valid ITSM host (example: subdomain-msp.cmdm.comodo.com )

 

Path 

/api/rest/v1/device-group

 

Method	POST
Content-Type	JSON (Application /json)

 

Request  Headers

Key	Value	Description
x-auth-type	4	Authentication type identifier
x-auth-token	access token	3rd Party Authentication  token

See the below link for details:

• Comodo ONE 3rd Party Authentication API Definition
• Token Renew Service
• Token Validation Service
• Usage of Access Token

 

Request test example:

{
    "name": "New Group Name",
    "company_id": 1
}

 

 

Execution

Sample execution can be handled via Postman Application. 

{ "title": "Create new Device Group", "type": "object", "properties": { "name": { "type": "string", "description":"Name of new group", "maxLength":80 }, "company_id": { "type": "number", "description":"Id of Company were group will be assigned. May be ommited in request and group should be assigned to Default Company" } }, "required": ["name"] }

Header part can be handled via Postman Application

Success Output

{ "title": "Response of group creation", "type": "object", "oneOf": [ { "required": ["model"] }, { "required": ["errors"] } ], "properties": { "model": { "type": "object", "properties": { "id": { "type": "number", "description": "Identifier of new group" }, "name": { "type": "string" }, "company_id": { "type": "number", "description": "Id of assigned company. By default it is Default Company" } } }, "errors": { "type": "object", "properties": { "name": { "type": "string", "description": "Errors related with " } } } } }

Error Output

Code Reason 200 Ok. 400 Bad request. Returns if mdmTokens is not provided or empty. Also you can get this error when required headers is missing 401 Unauthorized. Returns if x-auth-token is not provided 403 Forbidden. Returns if authentication failed