Read a task's current snapshot
Reads undeleted work in the authenticated company. Requires multiplayer_tasks.view or application_themes.view. Other-company and deleted identities return the same not-found response as an unknown task. The discussions the work was linked from are listed only for a caller with multiplayer_discussions.view; anyone else receives an empty list and learns no discussion ids or titles. The actor’s still-applicable Start request is returned only while that actor also has current execution permission. A saved standalone result is visible on the current task run to task readers.
curl --request GET \
--url https://api.fluid.app/api/v202604/multiplayer/tasks/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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 => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}")
.header("Authorization", "Bearer <token>")
.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::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"task": {
"id": "01a1d0e2-339b-7dab-a5b0-722a6845db0c",
"agency": null,
"agency_join_request": null,
"agency_request": null,
"assignee": null,
"assigner": null,
"board_position": "a0",
"board_position_at_ms": null,
"category": null,
"client_id": "evidence-task",
"company_id": 96778814,
"conversation_id": null,
"created_at": "2026-11-12T17:50:47Z",
"creator_id": 433400890,
"description": "",
"due_on": null,
"kind": null,
"lock_version": 0,
"merged_from": [],
"merged_into": null,
"mist_confidence": {
"state": "assessing"
},
"plan": null,
"priority": null,
"run_id": null,
"run_thread_id": null,
"source_threads": [],
"status": "open",
"status_editable": true,
"tags": [],
"title": "Fix the product page",
"updated_at": "2026-11-12T17:50:47Z"
},
"discussion_links": [
{
"id": "01a1d0e2-33bd-7f71-81d6-f339a1304d42",
"client_id": "evidence-link",
"created_at": "2026-11-12T17:50:47Z",
"created_work_item": false,
"discussion": {
"id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"title": "Fluid themes"
},
"discussion_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"linked_by": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"source_from_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"source_through_id": "01a1d0e2-3393-7d73-8937-59c724c33e4e",
"task_id": "01a1d0e2-339b-7dab-a5b0-722a6845db0c"
}
],
"start_request": null,
"accepted_start_request_run": false,
"result": null,
"evidence": [
{
"discussion_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"message_id": "01a1d0e2-3379-7492-9327-cbd8d086840d",
"resource_results": [
{
"receipt_id": "01a1d0e2-31c3-7365-8ee4-0f395484bfc4:product:0",
"request_id": "01a1d0e2-31c3-7365-8ee4-0f395484bfc4",
"tool_call_id": "product",
"recorded_at": "2026-11-12T17:50:47.430786Z",
"source_kind": "product",
"source_id": "836331430",
"state": "available",
"observation": "detail",
"admin_path": "/products/836331430",
"api_path": "/api/company/v1/products/836331430",
"required_permissions": [
"storefront.view"
],
"summary": {
"title": "Acme Product",
"sku": null,
"status": null,
"active": null,
"price": null,
"currency_code": null,
"in_stock": null,
"image_url": null,
"updated_at": null
}
},
{
"receipt_id": "01a1d0e2-31c3-7365-8ee4-0f395484bfc4:order:0",
"request_id": "01a1d0e2-31c3-7365-8ee4-0f395484bfc4",
"tool_call_id": "order",
"recorded_at": "2026-11-12T17:50:47.623643Z",
"source_kind": "order",
"source_id": "619885273",
"state": "available",
"observation": "detail",
"admin_path": "/orders/619885273",
"api_path": "/api/v2/orders/619885273",
"required_permissions": [
"orders.view"
],
"summary": {
"order_number": "1001",
"status": null,
"financial_status": null,
"fulfillment_status": null,
"created_at": null,
"customer_name": null,
"amount": null,
"currency_code": null,
"items_count": null,
"items": []
}
}
],
"page_results": []
}
],
"latest_review": null,
"checkable": false,
"editable": true,
"plannable": true,
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:50:47Z"
}
}{
"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.
Response
The current task and run identity, with the discussions it was linked from.
Show child attributes
Show child attributes
Links from the company's discussions to this work, oldest first. Empty without multiplayer_discussions.view; individual links are withheld when their conversation's original source, saved theme context, or retained commerce source permissions are no longer readable.
Show child attributes
Show child attributes
Current actor's latest applicable Start instruction, or null without execute permission or after it becomes stale. This read never authorizes a plain task link to start.
Show child attributes
Show child attributes
Whether the task's current run was bound by an accepted Start request, regardless of which actor requested it. False when there is no current run or it was started directly.
Plain result for this task's current standalone run, or null. Past runs are never presented as its current answer.
Show child attributes
Show child attributes
Product and order cards and storefront pages Cowork showed in the linked discussion messages, per message, oldest link first. Each is checked for the current reader as the conversation would be: the discussion must be readable, each card needs its own grant, and withdrawn records or moved pages keep no facts. Empty when nothing qualifies.
20Show child attributes
Show child attributes
Whether the reader may ask Mist to check this work now. The task is in review, Cowork is on, and the reader holds the check endpoint's grants.
Whether the reader may rewrite this work's title and request through the content endpoint now. No run holds the work or left its result on it, and the reader holds multiplayer_tasks.update or application_themes.update.
Whether the reader holds multiplayer_tasks.update or application_themes.update, the grant the priority, due date, owner, position and status endpoints ask for. A run on the work does not change it; each endpoint still checks the work's current state.
Mist's newest review of this work from a chat the reader may open, or null. Null without multiplayer_discussions.view or mist.view.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The ticket's images and files, oldest first, each with a link that reads it for ten minutes. Present only while the cowork-ticket-attachments release is on for the company; absent otherwise.
Show child attributes
Show child attributes
curl --request GET \
--url https://api.fluid.app/api/v202604/multiplayer/tasks/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
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 => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}")
.header("Authorization", "Bearer <token>")
.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::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"task": {
"id": "01a1d0e2-339b-7dab-a5b0-722a6845db0c",
"agency": null,
"agency_join_request": null,
"agency_request": null,
"assignee": null,
"assigner": null,
"board_position": "a0",
"board_position_at_ms": null,
"category": null,
"client_id": "evidence-task",
"company_id": 96778814,
"conversation_id": null,
"created_at": "2026-11-12T17:50:47Z",
"creator_id": 433400890,
"description": "",
"due_on": null,
"kind": null,
"lock_version": 0,
"merged_from": [],
"merged_into": null,
"mist_confidence": {
"state": "assessing"
},
"plan": null,
"priority": null,
"run_id": null,
"run_thread_id": null,
"source_threads": [],
"status": "open",
"status_editable": true,
"tags": [],
"title": "Fix the product page",
"updated_at": "2026-11-12T17:50:47Z"
},
"discussion_links": [
{
"id": "01a1d0e2-33bd-7f71-81d6-f339a1304d42",
"client_id": "evidence-link",
"created_at": "2026-11-12T17:50:47Z",
"created_work_item": false,
"discussion": {
"id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"title": "Fluid themes"
},
"discussion_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"linked_by": {
"id": "433400890",
"name": "Admin Acme",
"kind": "user"
},
"source_from_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"source_through_id": "01a1d0e2-3393-7d73-8937-59c724c33e4e",
"task_id": "01a1d0e2-339b-7dab-a5b0-722a6845db0c"
}
],
"start_request": null,
"accepted_start_request_run": false,
"result": null,
"evidence": [
{
"discussion_id": "00e4d19e-1655-5076-a2bb-5fc72b33393b",
"message_id": "01a1d0e2-3379-7492-9327-cbd8d086840d",
"resource_results": [
{
"receipt_id": "01a1d0e2-31c3-7365-8ee4-0f395484bfc4:product:0",
"request_id": "01a1d0e2-31c3-7365-8ee4-0f395484bfc4",
"tool_call_id": "product",
"recorded_at": "2026-11-12T17:50:47.430786Z",
"source_kind": "product",
"source_id": "836331430",
"state": "available",
"observation": "detail",
"admin_path": "/products/836331430",
"api_path": "/api/company/v1/products/836331430",
"required_permissions": [
"storefront.view"
],
"summary": {
"title": "Acme Product",
"sku": null,
"status": null,
"active": null,
"price": null,
"currency_code": null,
"in_stock": null,
"image_url": null,
"updated_at": null
}
},
{
"receipt_id": "01a1d0e2-31c3-7365-8ee4-0f395484bfc4:order:0",
"request_id": "01a1d0e2-31c3-7365-8ee4-0f395484bfc4",
"tool_call_id": "order",
"recorded_at": "2026-11-12T17:50:47.623643Z",
"source_kind": "order",
"source_id": "619885273",
"state": "available",
"observation": "detail",
"admin_path": "/orders/619885273",
"api_path": "/api/v2/orders/619885273",
"required_permissions": [
"orders.view"
],
"summary": {
"order_number": "1001",
"status": null,
"financial_status": null,
"fulfillment_status": null,
"created_at": null,
"customer_name": null,
"amount": null,
"currency_code": null,
"items_count": null,
"items": []
}
}
],
"page_results": []
}
],
"latest_review": null,
"checkable": false,
"editable": true,
"plannable": true,
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:50:47Z"
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_uuid": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}