Create an SLA policy
Define first-response and resolution targets for one priority.
/v1/sla-policiesEditor- Operation id
- create_sla
- Access
- A viewer is refused.
/v1/sla-policiesDefine first-response and resolution targets for one priority.
At least one of the two targets is required. The oldest enabled policy for a priority is the one stamped onto a ticket at create time and re-stamped when its priority changes.
Tenancy: the request is scoped to one workspace, and the credential presented is what selects it. A caller with no membership in that workspace is refused with 404, which is indistinguishable from a workspace that does not exist.
Authorisation: editor, admin or owner. A viewer receives 403 insufficient_role.
Access: Authorization: Bearer carrying either a realm access token or an API key. A key must hold the helpdesk-ops:write scope, and the workspace role of the person who owns it must meet the floor above.
A realm-issued access token, presented as Authorization: Bearer <token>. It acts as the person who signed in, and every operation resolves their workspace role live from the membership record.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/sla-policies" \ -H "Content-Type: application/json" \ -d '{ "name": "Urgent (15/240)" }'{}