Update admin task

put

https://{apiHost}/api/v2/public/admin-tasks/{taskId}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

taskId

string

required

Unique admin task identifier

Body Params

Admin task input for update operations. Every field is optional — only the supplied fields change. Fields accepted on create but NOT here (locationId, categoryIds, checklistTemplateId, relatedToType, relatedToId) are ignored: a task's location, category and related profile are fixed at creation. Use PUT /admin-tasks/{taskId}/checklist to update the checklist.

title

string

length ≤ 500

Task title

description

string | null

Task description

state

string

enum

Task state

Allowed:

priority

string

enum

Task priority

Allowed:

dueDate

date-time | null

Task due date (ISO 8601)

assigneeId

string | null

ID of staff member to assign

link

object | null

External link to attach to the task

Responses

422

The requested assigneeId does not hold a skill required by the task's
category (code: ASSIGNEE_MISSING_REQUIRED_SKILL). Only returned when the
organization restricts task assignment OR task visibility to matching skills,
AND the task's category is linked to a skill. A user holding that skill under EITHER
auto-assign or manual-only is accepted; only a user holding it under neither
is refused. Re-sending a task's existing assignee is always allowed, so a
status-only update never returns this.

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Admin task updated successfully

404Resource not found