Updates a task. Send only the fields you want to change.
An omitted field is left alone; re-sending a value the task already holds is a no-op rather than an error, and records no activity. Sending nothing at all is a 400.
Lists replace outright: send an empty array to clear one. LeadAssigneeId: 0
removes the lead, and ClearDueDate: true removes the due date - a date field is
never cleared by omission.
Changing the status fires the same automation the app fires.
Autorizações
Your Gorelo API key. See Generate API key. If your data is hosted in Australia, click the base URL at the top of this page and select https://api.aue.gorelo.io.
Parâmetros de caminho
Project the task belongs to.
Task to update.
Corpo
Fields to change.
Request body for updating a task. Every field is optional - send only what you want to change. An omitted field leaves the stored value alone; sending nothing at all is a 400 rather than a no-op write.
New task title.
Section to move the task to. Must be an active section of the same project.
New status: 1 Not started, 2 Working on it, 3 On hold, 4 Done.
Free-text reason recorded with the status. Only read when StatusId is sent.
New priority: None=0, Urgent=1, High=2, Normal=3, Low=4 - the ticket scale.
New due date (UTC). Send null to leave it alone; to clear it, send ClearDueDate.
Set true to remove the due date. A task's due date is otherwise never cleared by omission.
New lead assignee. Send 0 to remove the lead.
Replaces the assisting assignees outright. Send an empty array to remove them all.
Replaces the watchers outright. Send an empty array to remove them all.
Replaces the tasks that must finish before this one can.
Replaces the tasks this one is blocking.
Replaces the linked agent-managed assets.
Replaces the linked custom assets.
Replaces the linked uptime checks.
New banner text. Send an empty string to remove it.
Display name to record as the actor. An API key is not a person, so when it is
omitted or blank the actor is recorded as API.
Resposta
OK
100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 421, 422, 423, 424, 426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, 511 The identifier of the updated task.
null