Create a tier
Adds a tier, last in the order. An organization may have at most 50 tiers in use.
Requires the catalog:component:write scope.
Authorization
Request body required
namestringdescriptionstringcolorstringEmpty, or a hex colour such as#d97706.targetsSLATargetsShow SLATargets properties
availabilitynumberA percentage above 0 and at most 100, up to 3 decimals.responseobjectMinutes to acknowledge, per On-Call severity (critical,high,medium,low,info), 1 to 525600.resolutionobjectMinutes to resolve, per severity.support_hoursobjectkindstring requiredtimezonestringdaysarray of integerISO weekdays, 1 is Monday.fromstringtostring
max_unowned_daysinteger
Responses
201
The tier.
dataTierShow Tier properties
idstringnamestringdescriptionstringrankintegerIts place in the order, 1 the most critical.colorstringtargetsSLATargetsShow SLATargets properties
availabilitynumberA percentage above 0 and at most 100, up to 3 decimals.responseobjectMinutes to acknowledge, per On-Call severity (critical,high,medium,low,info), 1 to 525600.resolutionobjectMinutes to resolve, per severity.support_hoursobjectkindstring requiredtimezonestringdaysarray of integerISO weekdays, 1 is Monday.fromstringtostring
max_unowned_daysinteger
versionintegerarchived_atstring (date-time) | nullservicesintegerHow many services are in it.created_atstring (date-time)updated_atstring (date-time)
400
The request is not valid: a field or filter value is wrong
(VALIDATION_ERROR, with a sentence saying what), the body is not
the expected JSON or carries an unknown field (INVALID_BODY), the
cursor is not one this list gave (INVALID_CURSOR), a binding names
a service that does not exist (UNKNOWN_COMPONENT), or a PATCH
tries to change a slug (SLUG_IMMUTABLE).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
403
The key lacks a scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
409
Another tier already has this name (TIER_NAME_TAKEN).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
429
Too many requests (RATE_LIMITED). Wait for Retry-After seconds.
Retry-AfterintegerSeconds to wait before retrying.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
Example request
curl -X POST 'https://evohub.io/api/v1/catalog/tiers' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"name": "Customer facing",
"color": "#d97706",
"targets": {
"response": {
"high": 60,
"critical": 15
},
"resolution": {
"critical": 240
},
"availability": 99.9,
"support_hours": {
"kind": "24x7"
},
"max_unowned_days": 7
},
"description": "Anything a customer sees or pays through"
}'
