tasks

Updates an existing task. Only provided fields are modified.

Rate limit: 300 requests per minute

patch/tasks/{id}

Request

  • Base URL
    https://api.usepylon.com
  • URL
    https://api.usepylon.com/tasks/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID of the task to update.

Request body

ai_instructionsstring

Instructions the AI follows when evaluating this task in a smart project. Set to an empty string to clear them.

assignee_idstring

Assignee ID for this task

blocked_by_task_idsstring[]

IDs of the tasks that block this task. If provided, replaces the task's current blocking tasks; pass an empty array to remove them all.

body_htmlstring

Body HTML for this task

completed_atstring date-time

Completed at time for this task, in RFC 3339 format. The task must already have a completed status and completion date.

customer_portal_visibleboolean

Customer portal visible for this task

due_datestring

Due date for this task, in RFC 3339 format. Set to an empty string to clear it.

milestone_idstring

Milestone ID for this task

project_idstring

Project ID for this task

statusstring
titlestring

Title for this task

Response

request_idstring required

The request ID for tracking.

Example response

{
  "data": {
    "custom_fields": {
      "priority": {
        "value": "high"
      }
    }
  }
}

Changes

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status