Edit

[POST] .../v1/projecttask/edit

Edits a project task. Use this method to update task content such as parent task, name, description and mentions, CRM links, file lists or custom fields. The method modifies the existing task, synchronizes mentions/files/fields where provided, emits the usual task update notifications and webhooks and returns UpdateResult. The request body must contain id, the caller needs task edit permission, deal access is checked when a positive deal_id is supplied and invalid identifiers, parent hierarchy errors, denied access, missing task or persistent errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
attachment_file_ids Array of Int64 Optional Updated attachment file list.
client_id Int64 Optional New CRM client ID. Pass 0 to remove the current link.
deal_id Int64 Optional New CRM deal ID. Pass 0 to remove the current link.
description String Optional New task description.
description_mentions Array of CommonMentionInput Optional New list of structured mentions in description.
fields Array of FieldValueEdit Optional Custom field values.
id Int64 Required Task ID.
inline_file_ids Array of Int64 Optional Updated inline file list.
mention_options CommonMentionOptions Optional Mention processing options.
name String Optional New task name.
parent_task_id Int64 Optional New parent task ID. Must reference an existing task.

Request Example

{
  "id": 101,
  "name": "Prepare final store opening checklist",
  "description": "Update the operational checklist.",
  "attachment_file_ids": [
    42,
    43
  ],
  "inline_file_ids": []
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 1
  }
}