OK
{
"category": {
"id": "4ca8dcff-5ebb-b236-ea2f-0bfbdf3c623e",
"displayName": "Equipment",
"createdDateTime": "2019-11-26T17:12:40.8516569Z",
"lastModifiedDateTime": "2019-11-26T17:14:12.3846681Z"
}
}
This response indicates that request lacks valid authentication credentials. Access token might not been provided, issued by the wrong issuer, does not have required scopes or request headers were malformed.
{
"error": {
"code": "HeaderNotFound",
"message": "Header Authorization was not found in the request. Access denied."
}
}
This response indicates that user does not have required permissions to create category.
{
"error": {
"code": "InsufficientPermissions",
"message": "The user has insufficient permissions for the requested operation."
}
}
This response indicates that the specified category not found.
{
"error": {
"code": "CategoryNotFound",
"message": "Requested Category is not available."
}
}
Catalog with the same name already exists within the organization.
{
"error": {
"code": "CategoryExists",
"message": "Category with the same name already exists within the organization."
}
}
Invalid request to upload component.
{
"error": {
"code": "InvalidCreateCategoryRequest",
"message": "Cannot create category.",
"details": [{
"code": "MissingRequiredProperty",
"message": "Required property is missing.",
"target": "displayName"
},
{
"code": "InvalidValue",
"message": "DisplayName is over '250' length limit.",
"target": "displayName"
},
{
"code": "InvalidValue",
"message": "DisplayName must not include these special characters. >, <, ^, $, ?, ||.",
"target": "displayName"
}
]
}
}
This response indicates that the user has sent too many requests in a given amount of time.
{
"error": {
"code": "TooManyRequests",
"message": "More requests were received than the subscription rate-limit allows."
}
}