PEperiskope
tasks

Update Task

This endpoint updates info about a specific task

patch/tasks/{task_id}

Request

  • Base URL
    https://api.periskope.app/v1
  • URL
    https://api.periskope.app/v1/tasks/{task_id}
  • Auth
    HTTP bearer

Request body

titlestring required
  • The title of the task (1–500 characters)
status'open' | 'inprogress' | 'closed'
  • Status of the task
  • Possible values: open, inprogress, closed
  • Default open
priority1 | 2 | 3
  • The priority of the task
  • Possible values: 1, 2, 3
  • Default 1
assigneestring
  • Email of an org member. Validated against your org's member list
due_datestring
  • The due date of the task
  • Should be in ISO 8601 timestamp format
notesstring
  • Free-form text attached to the task
remind_atstring
  • The remind date for the task to receive a reminder
  • Should be in ISO 8601 timestamp format
last_updated_bystring
  • Email of an org member. Defaults to "api".
  • Used as completed_by when this update closes the task

Example request

{
  "title": "Resolve customer escalation",
  "status": "closed",
  "priority": 3,
  "assignee": "ankit.singh@hashlabs.dev",
  "due_date": "2026-06-15T18:00:00+00:00",
  "notes": "Customer escalated via email — coordinate with support",
  "remind_at": "2026-06-18T18:00:00+00:00",
  "last_updated_by": "ankit.singh@hashlabs.dev"
}

Response

200 OK

object required

The response is a task object. Refer to the task object here

Changes

No recorded changes to this operation across all 2 revisions of this API.