Cowork tasks
Change what the company's work says
Changes any of the work’s title, description, kind, priority and due date in one write; send only the fields that change, and at least one. Requires a user session with multiplayer_tasks.update or the existing application_themes.update permission. The version the client observed is compared with the stored one, so a change made against a stale view is refused and answered with the current task instead of merged. Status, assignment and board position keep their own routes. Work in another company, deleted work, and an unknown id all answer the same not-found; work deleted after that read and before the change lands answers 410. A successful write announces a data-free invalidation on every theme this work’s linked discussions sit on.
PATCH
/
api
/
v202604
/
multiplayer
/
tasks
/
{id}
Change what the company's work says
curl --request PATCH \
--url https://api.fluid.app/api/v202604/multiplayer/tasks/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"task": {
"title": "Fix footer links on mobile",
"description": "The footer links wrap on phones.",
"kind": "bug",
"priority": "high",
"due_on": "2026-10-16",
"expected_version": 0
}
}
'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}"
payload = { "task": {
"title": "Fix footer links on mobile",
"description": "The footer links wrap on phones.",
"kind": "bug",
"priority": "high",
"due_on": "2026-10-16",
"expected_version": 0
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
task: {
title: 'Fix footer links on mobile',
description: 'The footer links wrap on phones.',
kind: 'bug',
priority: 'high',
due_on: '2026-10-16',
expected_version: 0
}
})
};
fetch('https://api.fluid.app/api/v202604/multiplayer/tasks/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'task' => [
'title' => 'Fix footer links on mobile',
'description' => 'The footer links wrap on phones.',
'kind' => 'bug',
'priority' => 'high',
'due_on' => '2026-10-16',
'expected_version' => 0
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}"
payload := strings.NewReader("{\n \"task\": {\n \"title\": \"Fix footer links on mobile\",\n \"description\": \"The footer links wrap on phones.\",\n \"kind\": \"bug\",\n \"priority\": \"high\",\n \"due_on\": \"2026-10-16\",\n \"expected_version\": 0\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"task\": {\n \"title\": \"Fix footer links on mobile\",\n \"description\": \"The footer links wrap on phones.\",\n \"kind\": \"bug\",\n \"priority\": \"high\",\n \"due_on\": \"2026-10-16\",\n \"expected_version\": 0\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"task\": {\n \"title\": \"Fix footer links on mobile\",\n \"description\": \"The footer links wrap on phones.\",\n \"kind\": \"bug\",\n \"priority\": \"high\",\n \"due_on\": \"2026-10-16\",\n \"expected_version\": 0\n }\n}"
response = http.request(request)
puts response.read_body{
"task": {
"id": "9271f7b9-237c-5dbe-ab78-f866652d747a",
"agency": null,
"agency_join_request": null,
"agency_request": null,
"assignee": null,
"assigner": null,
"board_position": null,
"board_position_at_ms": null,
"category": "eng",
"client_id": "acme-videos",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:31Z",
"creator_id": 433400890,
"description": "The footer links wrap on phones.",
"due_on": "2026-10-16",
"kind": "bug",
"lock_version": 1,
"merged_from": [],
"merged_into": null,
"mist_confidence": {
"state": "not_assessed"
},
"plan": null,
"priority": "high",
"run_id": null,
"run_thread_id": null,
"source_threads": [],
"status": "open",
"status_editable": true,
"tags": [],
"title": "Fix footer links on mobile",
"updated_at": "2026-11-12T17:53:02Z"
},
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:53:02Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {
"type": "conflict",
"merged_into": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>"
},
"task": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_id": "<string>",
"company_id": 123,
"creator_id": 123,
"title": "<string>",
"description": "<string>",
"status": "open",
"priority": "urgent",
"due_on": "2023-12-25",
"kind": "bug",
"category": "design",
"plan": [
{
"title": "<string>",
"outcome": "<string>"
}
],
"board_position": "<string>",
"board_position_at_ms": 123,
"lock_version": 1,
"run_id": "<string>",
"run_thread_id": 123,
"tags": [
"<string>"
],
"agency": {
"key": "example_agency",
"name": "Example agency"
},
"assignee": {
"id": "<string>",
"name": "<string>",
"kind": "user"
},
"assigner": {
"id": "<string>",
"name": "<string>",
"kind": "user"
},
"source_threads": [
{
"id": 123,
"theme_id": 123,
"client_id": "<string>",
"n": 123,
"page_url": "<string>",
"author_name": "<string>"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"mist_confidence": {
"state": "current",
"score": 3,
"band": "red",
"summary": "<string>",
"concerns": [
"<string>"
],
"raise_by": [
"<string>"
],
"assessed_at": "2023-11-07T05:31:56Z",
"failure": "budget",
"assessment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"suggested_kind": "bug",
"category": "design",
"difficulty": "easy",
"hours_low": 80,
"hours_high": 80,
"questions": [
{
"id": "q1",
"prompt": "<string>",
"options": [
"<string>"
]
}
],
"duplicate_of": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"status": "open",
"reason": "<string>",
"merge_blocked": "agency"
}
},
"source": {
"provider": "linear",
"identifier": "<string>",
"url": "<string>"
},
"attachment_count": 1,
"agency_request": {
"agency": {
"key": "example_agency",
"name": "Example agency"
},
"owner": {
"id": "<string>",
"name": "<string>"
},
"access": [
{
"person": {
"id": "<string>",
"name": "<string>"
},
"role": {
"id": 123,
"name": "<string>"
}
}
],
"owner_has_access": true,
"state": "sent",
"stage": "requested",
"version": 1,
"sent_at": "2023-11-07T05:31:56Z",
"quote": {
"hours": 123,
"deliver_on": "2023-12-25",
"note": "<string>",
"quoted_at": "2023-11-07T05:31:56Z"
},
"revised_quote": {
"hours": 123,
"deliver_on": "2023-12-25",
"note": "<string>",
"quoted_at": "2023-11-07T05:31:56Z"
},
"changes_round": 1,
"reopenable_until": "2023-11-07T05:31:56Z",
"delivery_overdue": true,
"last_step": {
"kind": "<string>",
"at": "2023-11-07T05:31:56Z",
"note": "<string>"
}
},
"agency_join_request": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "pending",
"agency_name": "<string>",
"decline_reason": "<string>",
"requested_at": "2023-11-07T05:31:56Z",
"lock_version": 1
},
"merged_into": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"deleted": true
},
"merged_from": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"merged_at": "2023-11-07T05:31:56Z",
"version": 1
}
],
"conversation_id": 123,
"status_editable": true
}
}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The task UUID returned at creation or in a task page.
Body
application/json
Show child attributes
Show child attributes
⌘I
Change what the company's work says
curl --request PATCH \
--url https://api.fluid.app/api/v202604/multiplayer/tasks/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"task": {
"title": "Fix footer links on mobile",
"description": "The footer links wrap on phones.",
"kind": "bug",
"priority": "high",
"due_on": "2026-10-16",
"expected_version": 0
}
}
'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}"
payload = { "task": {
"title": "Fix footer links on mobile",
"description": "The footer links wrap on phones.",
"kind": "bug",
"priority": "high",
"due_on": "2026-10-16",
"expected_version": 0
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
task: {
title: 'Fix footer links on mobile',
description: 'The footer links wrap on phones.',
kind: 'bug',
priority: 'high',
due_on: '2026-10-16',
expected_version: 0
}
})
};
fetch('https://api.fluid.app/api/v202604/multiplayer/tasks/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'task' => [
'title' => 'Fix footer links on mobile',
'description' => 'The footer links wrap on phones.',
'kind' => 'bug',
'priority' => 'high',
'due_on' => '2026-10-16',
'expected_version' => 0
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}"
payload := strings.NewReader("{\n \"task\": {\n \"title\": \"Fix footer links on mobile\",\n \"description\": \"The footer links wrap on phones.\",\n \"kind\": \"bug\",\n \"priority\": \"high\",\n \"due_on\": \"2026-10-16\",\n \"expected_version\": 0\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"task\": {\n \"title\": \"Fix footer links on mobile\",\n \"description\": \"The footer links wrap on phones.\",\n \"kind\": \"bug\",\n \"priority\": \"high\",\n \"due_on\": \"2026-10-16\",\n \"expected_version\": 0\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"task\": {\n \"title\": \"Fix footer links on mobile\",\n \"description\": \"The footer links wrap on phones.\",\n \"kind\": \"bug\",\n \"priority\": \"high\",\n \"due_on\": \"2026-10-16\",\n \"expected_version\": 0\n }\n}"
response = http.request(request)
puts response.read_body{
"task": {
"id": "9271f7b9-237c-5dbe-ab78-f866652d747a",
"agency": null,
"agency_join_request": null,
"agency_request": null,
"assignee": null,
"assigner": null,
"board_position": null,
"board_position_at_ms": null,
"category": "eng",
"client_id": "acme-videos",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:31Z",
"creator_id": 433400890,
"description": "The footer links wrap on phones.",
"due_on": "2026-10-16",
"kind": "bug",
"lock_version": 1,
"merged_from": [],
"merged_into": null,
"mist_confidence": {
"state": "not_assessed"
},
"plan": null,
"priority": "high",
"run_id": null,
"run_thread_id": null,
"source_threads": [],
"status": "open",
"status_editable": true,
"tags": [],
"title": "Fix footer links on mobile",
"updated_at": "2026-11-12T17:53:02Z"
},
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:53:02Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {
"type": "conflict",
"merged_into": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>"
},
"task": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_id": "<string>",
"company_id": 123,
"creator_id": 123,
"title": "<string>",
"description": "<string>",
"status": "open",
"priority": "urgent",
"due_on": "2023-12-25",
"kind": "bug",
"category": "design",
"plan": [
{
"title": "<string>",
"outcome": "<string>"
}
],
"board_position": "<string>",
"board_position_at_ms": 123,
"lock_version": 1,
"run_id": "<string>",
"run_thread_id": 123,
"tags": [
"<string>"
],
"agency": {
"key": "example_agency",
"name": "Example agency"
},
"assignee": {
"id": "<string>",
"name": "<string>",
"kind": "user"
},
"assigner": {
"id": "<string>",
"name": "<string>",
"kind": "user"
},
"source_threads": [
{
"id": 123,
"theme_id": 123,
"client_id": "<string>",
"n": 123,
"page_url": "<string>",
"author_name": "<string>"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"mist_confidence": {
"state": "current",
"score": 3,
"band": "red",
"summary": "<string>",
"concerns": [
"<string>"
],
"raise_by": [
"<string>"
],
"assessed_at": "2023-11-07T05:31:56Z",
"failure": "budget",
"assessment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"suggested_kind": "bug",
"category": "design",
"difficulty": "easy",
"hours_low": 80,
"hours_high": 80,
"questions": [
{
"id": "q1",
"prompt": "<string>",
"options": [
"<string>"
]
}
],
"duplicate_of": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"status": "open",
"reason": "<string>",
"merge_blocked": "agency"
}
},
"source": {
"provider": "linear",
"identifier": "<string>",
"url": "<string>"
},
"attachment_count": 1,
"agency_request": {
"agency": {
"key": "example_agency",
"name": "Example agency"
},
"owner": {
"id": "<string>",
"name": "<string>"
},
"access": [
{
"person": {
"id": "<string>",
"name": "<string>"
},
"role": {
"id": 123,
"name": "<string>"
}
}
],
"owner_has_access": true,
"state": "sent",
"stage": "requested",
"version": 1,
"sent_at": "2023-11-07T05:31:56Z",
"quote": {
"hours": 123,
"deliver_on": "2023-12-25",
"note": "<string>",
"quoted_at": "2023-11-07T05:31:56Z"
},
"revised_quote": {
"hours": 123,
"deliver_on": "2023-12-25",
"note": "<string>",
"quoted_at": "2023-11-07T05:31:56Z"
},
"changes_round": 1,
"reopenable_until": "2023-11-07T05:31:56Z",
"delivery_overdue": true,
"last_step": {
"kind": "<string>",
"at": "2023-11-07T05:31:56Z",
"note": "<string>"
}
},
"agency_join_request": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "pending",
"agency_name": "<string>",
"decline_reason": "<string>",
"requested_at": "2023-11-07T05:31:56Z",
"lock_version": 1
},
"merged_into": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"deleted": true
},
"merged_from": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"merged_at": "2023-11-07T05:31:56Z",
"version": 1
}
],
"conversation_id": 123,
"status_editable": true
}
}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}