Replace the escalation steps of a category. Each hour, late or nearly late work moves up one step: reminders, notices to reviewers, people or a role, a higher priority, or handing the work to someone else
PUT
https://app.softsolz.uk/api/v1/services/tasks/categories/{id}/escalationRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
stepsarray of objectsUp to 5 steps, run in time order, one step at a time.
Response
Response Body
category_idintegerThe category.escalationobjectIts escalation steps.Request
curl --request PUT \ --url https://app.softsolz.uk/api/v1/services/tasks/categories/{id}/escalation \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "steps": [ { "after_hours": 0, "relative": "overdue", "actions": [ { "type": "remind_assignee" } ] }, { "after_hours": 24, "relative": "overdue", "actions": [ { "type": "notify_reviewers" } ] } ]}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 200
{ "data": { "category_id": 1, "escalation": { "steps": [ { "after_hours": 24, "relative": "overdue", "actions": [ {} ] } ] } }}