Skip to main content
PATCH
Update task
Partial update — send only the fields you want to change. For example, to update title and status:
Updatable fields: title, body, statusCase, assignedAgentIds, viewedByAgentIds, dueDate, participantsIdentifiers, phoneNumberId. The server always refreshes updatedAt and agentIdentification, and increments unreadCount.

Authorizations

Personal access token from Pingmee Settings → Developer Tools

x-api-key
string
header
required

Business API key from Pingmee Settings → Developer Tools

Path Parameters

taskId
string
required

Task identifier returned when the task was created.

Body

application/json

Fields to update. Omit fields you do not want to change.

Partial task update. Include only the fields you want to change. unreadCount, updatedAt, and agentIdentification are set by the server.

title
string

Task title.

body
string

Task description / notes.

statusCase
string

Task status. Built-in values are open, standby (in progress), and completed. Custom task status IDs defined for the business are also accepted.

assignedAgentIds
string[]

Agent IDs assigned to this task. Replaces the full assignment list.

viewedByAgentIds
string[]

Agent IDs that have viewed this task.

dueDate
number

Unix timestamp (seconds) for the due date. 0 to unset.

participantsIdentifiers
string

Conversation participants identifiers this task is linked to.

phoneNumberId
string

Business phone number identifier used to scope the task.

Response

Task updated

task
object
required
Last modified on August 30, 2026