Mist runs
End the run and store the answer it has to show
Requires a user session with multiplayer_tasks.execute or the existing application_themes.update permission. Moves work the run still owns to review (or to needs_info when the backstop marks the run unfinished, which must then carry a reply or result saying why) and, when a reply is supplied, stores it on the discussion that run was claimed from — both under one transaction, so a refused answer leaves the work where it was and a refused completion takes the answer back out. Omit expected_version and the run is answering for itself, so a priority set while it was out does not lose its answer; supply one for the backstop, which wants the work only if nothing has happened to it since. A reply is required while the discussion the run was claimed from is undeleted and still linked to this work, and finishing without one then is refused. Omit reply when there is no such discussion: standalone work, or a discussion deleted or unlinked while the run was out, which finishes without one rather than leaving the work stuck; supplying one for such work is refused. A standalone run accepted through a saved Start request instead requires a bounded plain-text result, stored on that same request in the completion transaction. Legacy standalone runs without a Start request may still finish without a result. Work in another company, deleted work, and an unknown id all answer the same not-found; work deleted after that read and before the completion lands answers 410. A successful completion announces a data-free invalidation on every theme this work’s linked discussions sit on.
POST
/
api
/
v202604
/
multiplayer
/
tasks
/
{id}
/
run
/
finish
End the run and store the answer it has to show
curl --request POST \
--url https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"run": {
"run_id": "finish-0002"
},
"reply": {
"client_id": "run-answer-0001",
"body": "Set the heading to your collection.",
"shot": {
"width": 1280,
"height": 720,
"asset_id": 1050970312
},
"proof": {
"route": "/home/shop",
"checks": [
{
"label": "Rendered",
"status": "pass"
}
],
"record_changes": [
{
"label": "Updated product",
"method": "PATCH",
"path": "/api/v202604/company/products/7",
"outcome": "uncertain",
"fields": [
{
"path": "price",
"before": "40",
"after": "45"
}
]
}
],
"data_snapshots": [
{
"label": "Best sellers",
"path": "/api/v202604/analytics/dashboard/best_sellers",
"rows": [
{
"path": "data[0].name",
"before": "Cap",
"after": "Hoodie"
}
]
}
]
}
}
}
'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish"
payload = {
"run": { "run_id": "finish-0002" },
"reply": {
"client_id": "run-answer-0001",
"body": "Set the heading to your collection.",
"shot": {
"width": 1280,
"height": 720,
"asset_id": 1050970312
},
"proof": {
"route": "/home/shop",
"checks": [
{
"label": "Rendered",
"status": "pass"
}
],
"record_changes": [
{
"label": "Updated product",
"method": "PATCH",
"path": "/api/v202604/company/products/7",
"outcome": "uncertain",
"fields": [
{
"path": "price",
"before": "40",
"after": "45"
}
]
}
],
"data_snapshots": [
{
"label": "Best sellers",
"path": "/api/v202604/analytics/dashboard/best_sellers",
"rows": [
{
"path": "data[0].name",
"before": "Cap",
"after": "Hoodie"
}
]
}
]
}
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
run: {run_id: 'finish-0002'},
reply: {
client_id: 'run-answer-0001',
body: JSON.stringify('Set the heading to your collection.'),
shot: {width: 1280, height: 720, asset_id: 1050970312},
proof: {
route: '/home/shop',
checks: [{label: 'Rendered', status: 'pass'}],
record_changes: [
{
label: 'Updated product',
method: 'PATCH',
path: '/api/v202604/company/products/7',
outcome: 'uncertain',
fields: [{path: 'price', before: '40', after: '45'}]
}
],
data_snapshots: [
{
label: 'Best sellers',
path: '/api/v202604/analytics/dashboard/best_sellers',
rows: [{path: 'data[0].name', before: 'Cap', after: 'Hoodie'}]
}
]
}
}
})
};
fetch('https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish', 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}/run/finish",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'run' => [
'run_id' => 'finish-0002'
],
'reply' => [
'client_id' => 'run-answer-0001',
'body' => 'Set the heading to your collection.',
'shot' => [
'width' => 1280,
'height' => 720,
'asset_id' => 1050970312
],
'proof' => [
'route' => '/home/shop',
'checks' => [
[
'label' => 'Rendered',
'status' => 'pass'
]
],
'record_changes' => [
[
'label' => 'Updated product',
'method' => 'PATCH',
'path' => '/api/v202604/company/products/7',
'outcome' => 'uncertain',
'fields' => [
[
'path' => 'price',
'before' => '40',
'after' => '45'
]
]
]
],
'data_snapshots' => [
[
'label' => 'Best sellers',
'path' => '/api/v202604/analytics/dashboard/best_sellers',
'rows' => [
[
'path' => 'data[0].name',
'before' => 'Cap',
'after' => 'Hoodie'
]
]
]
]
]
]
]),
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}/run/finish"
payload := strings.NewReader("{\n \"run\": {\n \"run_id\": \"finish-0002\"\n },\n \"reply\": {\n \"client_id\": \"run-answer-0001\",\n \"body\": \"Set the heading to your collection.\",\n \"shot\": {\n \"width\": 1280,\n \"height\": 720,\n \"asset_id\": 1050970312\n },\n \"proof\": {\n \"route\": \"/home/shop\",\n \"checks\": [\n {\n \"label\": \"Rendered\",\n \"status\": \"pass\"\n }\n ],\n \"record_changes\": [\n {\n \"label\": \"Updated product\",\n \"method\": \"PATCH\",\n \"path\": \"/api/v202604/company/products/7\",\n \"outcome\": \"uncertain\",\n \"fields\": [\n {\n \"path\": \"price\",\n \"before\": \"40\",\n \"after\": \"45\"\n }\n ]\n }\n ],\n \"data_snapshots\": [\n {\n \"label\": \"Best sellers\",\n \"path\": \"/api/v202604/analytics/dashboard/best_sellers\",\n \"rows\": [\n {\n \"path\": \"data[0].name\",\n \"before\": \"Cap\",\n \"after\": \"Hoodie\"\n }\n ]\n }\n ]\n }\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"run\": {\n \"run_id\": \"finish-0002\"\n },\n \"reply\": {\n \"client_id\": \"run-answer-0001\",\n \"body\": \"Set the heading to your collection.\",\n \"shot\": {\n \"width\": 1280,\n \"height\": 720,\n \"asset_id\": 1050970312\n },\n \"proof\": {\n \"route\": \"/home/shop\",\n \"checks\": [\n {\n \"label\": \"Rendered\",\n \"status\": \"pass\"\n }\n ],\n \"record_changes\": [\n {\n \"label\": \"Updated product\",\n \"method\": \"PATCH\",\n \"path\": \"/api/v202604/company/products/7\",\n \"outcome\": \"uncertain\",\n \"fields\": [\n {\n \"path\": \"price\",\n \"before\": \"40\",\n \"after\": \"45\"\n }\n ]\n }\n ],\n \"data_snapshots\": [\n {\n \"label\": \"Best sellers\",\n \"path\": \"/api/v202604/analytics/dashboard/best_sellers\",\n \"rows\": [\n {\n \"path\": \"data[0].name\",\n \"before\": \"Cap\",\n \"after\": \"Hoodie\"\n }\n ]\n }\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"run\": {\n \"run_id\": \"finish-0002\"\n },\n \"reply\": {\n \"client_id\": \"run-answer-0001\",\n \"body\": \"Set the heading to your collection.\",\n \"shot\": {\n \"width\": 1280,\n \"height\": 720,\n \"asset_id\": 1050970312\n },\n \"proof\": {\n \"route\": \"/home/shop\",\n \"checks\": [\n {\n \"label\": \"Rendered\",\n \"status\": \"pass\"\n }\n ],\n \"record_changes\": [\n {\n \"label\": \"Updated product\",\n \"method\": \"PATCH\",\n \"path\": \"/api/v202604/company/products/7\",\n \"outcome\": \"uncertain\",\n \"fields\": [\n {\n \"path\": \"price\",\n \"before\": \"40\",\n \"after\": \"45\"\n }\n ]\n }\n ],\n \"data_snapshots\": [\n {\n \"label\": \"Best sellers\",\n \"path\": \"/api/v202604/analytics/dashboard/best_sellers\",\n \"rows\": [\n {\n \"path\": \"data[0].name\",\n \"before\": \"Cap\",\n \"after\": \"Hoodie\"\n }\n ]\n }\n ]\n }\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": null,
"client_id": "acme-videos",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:31Z",
"creator_id": 433400890,
"description": "Use videos from the media library",
"due_on": null,
"kind": null,
"lock_version": 2,
"merged_from": [],
"merged_into": null,
"mist_confidence": {
"state": "not_assessed"
},
"plan": null,
"priority": null,
"run_id": "finish-0002",
"run_thread_id": 923023514,
"source_threads": [
{
"id": 809222460,
"theme_id": 520942414,
"client_id": "comment-resolved-0003",
"n": 3,
"page_url": "/home",
"author_name": "Rep Acme"
},
{
"id": 923023514,
"theme_id": 520942414,
"client_id": "comment-open-0001",
"n": 1,
"page_url": "/home/shop",
"author_name": "Admin Acme"
}
],
"status": "review",
"status_editable": true,
"tags": [],
"title": "Add customer videos",
"updated_at": "2026-11-12T17:52:36Z"
},
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:52:36Z"
}
}{
"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
The answer to store on the discussion this run was claimed from. Required while that discussion is undeleted and still linked to this work; omit it when there is none.
Show child attributes
Show child attributes
Plain result for a standalone run accepted through a Start request. Required for that run; omit for preview replies or legacy standalone runs. Each field is limited to 32 KiB of UTF-8 text. Proof is reported evidence or links, not a claim of verified release.
Show child attributes
Show child attributes
⌘I
End the run and store the answer it has to show
curl --request POST \
--url https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"run": {
"run_id": "finish-0002"
},
"reply": {
"client_id": "run-answer-0001",
"body": "Set the heading to your collection.",
"shot": {
"width": 1280,
"height": 720,
"asset_id": 1050970312
},
"proof": {
"route": "/home/shop",
"checks": [
{
"label": "Rendered",
"status": "pass"
}
],
"record_changes": [
{
"label": "Updated product",
"method": "PATCH",
"path": "/api/v202604/company/products/7",
"outcome": "uncertain",
"fields": [
{
"path": "price",
"before": "40",
"after": "45"
}
]
}
],
"data_snapshots": [
{
"label": "Best sellers",
"path": "/api/v202604/analytics/dashboard/best_sellers",
"rows": [
{
"path": "data[0].name",
"before": "Cap",
"after": "Hoodie"
}
]
}
]
}
}
}
'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish"
payload = {
"run": { "run_id": "finish-0002" },
"reply": {
"client_id": "run-answer-0001",
"body": "Set the heading to your collection.",
"shot": {
"width": 1280,
"height": 720,
"asset_id": 1050970312
},
"proof": {
"route": "/home/shop",
"checks": [
{
"label": "Rendered",
"status": "pass"
}
],
"record_changes": [
{
"label": "Updated product",
"method": "PATCH",
"path": "/api/v202604/company/products/7",
"outcome": "uncertain",
"fields": [
{
"path": "price",
"before": "40",
"after": "45"
}
]
}
],
"data_snapshots": [
{
"label": "Best sellers",
"path": "/api/v202604/analytics/dashboard/best_sellers",
"rows": [
{
"path": "data[0].name",
"before": "Cap",
"after": "Hoodie"
}
]
}
]
}
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
run: {run_id: 'finish-0002'},
reply: {
client_id: 'run-answer-0001',
body: JSON.stringify('Set the heading to your collection.'),
shot: {width: 1280, height: 720, asset_id: 1050970312},
proof: {
route: '/home/shop',
checks: [{label: 'Rendered', status: 'pass'}],
record_changes: [
{
label: 'Updated product',
method: 'PATCH',
path: '/api/v202604/company/products/7',
outcome: 'uncertain',
fields: [{path: 'price', before: '40', after: '45'}]
}
],
data_snapshots: [
{
label: 'Best sellers',
path: '/api/v202604/analytics/dashboard/best_sellers',
rows: [{path: 'data[0].name', before: 'Cap', after: 'Hoodie'}]
}
]
}
}
})
};
fetch('https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish', 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}/run/finish",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'run' => [
'run_id' => 'finish-0002'
],
'reply' => [
'client_id' => 'run-answer-0001',
'body' => 'Set the heading to your collection.',
'shot' => [
'width' => 1280,
'height' => 720,
'asset_id' => 1050970312
],
'proof' => [
'route' => '/home/shop',
'checks' => [
[
'label' => 'Rendered',
'status' => 'pass'
]
],
'record_changes' => [
[
'label' => 'Updated product',
'method' => 'PATCH',
'path' => '/api/v202604/company/products/7',
'outcome' => 'uncertain',
'fields' => [
[
'path' => 'price',
'before' => '40',
'after' => '45'
]
]
]
],
'data_snapshots' => [
[
'label' => 'Best sellers',
'path' => '/api/v202604/analytics/dashboard/best_sellers',
'rows' => [
[
'path' => 'data[0].name',
'before' => 'Cap',
'after' => 'Hoodie'
]
]
]
]
]
]
]),
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}/run/finish"
payload := strings.NewReader("{\n \"run\": {\n \"run_id\": \"finish-0002\"\n },\n \"reply\": {\n \"client_id\": \"run-answer-0001\",\n \"body\": \"Set the heading to your collection.\",\n \"shot\": {\n \"width\": 1280,\n \"height\": 720,\n \"asset_id\": 1050970312\n },\n \"proof\": {\n \"route\": \"/home/shop\",\n \"checks\": [\n {\n \"label\": \"Rendered\",\n \"status\": \"pass\"\n }\n ],\n \"record_changes\": [\n {\n \"label\": \"Updated product\",\n \"method\": \"PATCH\",\n \"path\": \"/api/v202604/company/products/7\",\n \"outcome\": \"uncertain\",\n \"fields\": [\n {\n \"path\": \"price\",\n \"before\": \"40\",\n \"after\": \"45\"\n }\n ]\n }\n ],\n \"data_snapshots\": [\n {\n \"label\": \"Best sellers\",\n \"path\": \"/api/v202604/analytics/dashboard/best_sellers\",\n \"rows\": [\n {\n \"path\": \"data[0].name\",\n \"before\": \"Cap\",\n \"after\": \"Hoodie\"\n }\n ]\n }\n ]\n }\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"run\": {\n \"run_id\": \"finish-0002\"\n },\n \"reply\": {\n \"client_id\": \"run-answer-0001\",\n \"body\": \"Set the heading to your collection.\",\n \"shot\": {\n \"width\": 1280,\n \"height\": 720,\n \"asset_id\": 1050970312\n },\n \"proof\": {\n \"route\": \"/home/shop\",\n \"checks\": [\n {\n \"label\": \"Rendered\",\n \"status\": \"pass\"\n }\n ],\n \"record_changes\": [\n {\n \"label\": \"Updated product\",\n \"method\": \"PATCH\",\n \"path\": \"/api/v202604/company/products/7\",\n \"outcome\": \"uncertain\",\n \"fields\": [\n {\n \"path\": \"price\",\n \"before\": \"40\",\n \"after\": \"45\"\n }\n ]\n }\n ],\n \"data_snapshots\": [\n {\n \"label\": \"Best sellers\",\n \"path\": \"/api/v202604/analytics/dashboard/best_sellers\",\n \"rows\": [\n {\n \"path\": \"data[0].name\",\n \"before\": \"Cap\",\n \"after\": \"Hoodie\"\n }\n ]\n }\n ]\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/run/finish")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"run\": {\n \"run_id\": \"finish-0002\"\n },\n \"reply\": {\n \"client_id\": \"run-answer-0001\",\n \"body\": \"Set the heading to your collection.\",\n \"shot\": {\n \"width\": 1280,\n \"height\": 720,\n \"asset_id\": 1050970312\n },\n \"proof\": {\n \"route\": \"/home/shop\",\n \"checks\": [\n {\n \"label\": \"Rendered\",\n \"status\": \"pass\"\n }\n ],\n \"record_changes\": [\n {\n \"label\": \"Updated product\",\n \"method\": \"PATCH\",\n \"path\": \"/api/v202604/company/products/7\",\n \"outcome\": \"uncertain\",\n \"fields\": [\n {\n \"path\": \"price\",\n \"before\": \"40\",\n \"after\": \"45\"\n }\n ]\n }\n ],\n \"data_snapshots\": [\n {\n \"label\": \"Best sellers\",\n \"path\": \"/api/v202604/analytics/dashboard/best_sellers\",\n \"rows\": [\n {\n \"path\": \"data[0].name\",\n \"before\": \"Cap\",\n \"after\": \"Hoodie\"\n }\n ]\n }\n ]\n }\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": null,
"client_id": "acme-videos",
"company_id": 96778814,
"created_at": "2026-11-12T17:50:31Z",
"creator_id": 433400890,
"description": "Use videos from the media library",
"due_on": null,
"kind": null,
"lock_version": 2,
"merged_from": [],
"merged_into": null,
"mist_confidence": {
"state": "not_assessed"
},
"plan": null,
"priority": null,
"run_id": "finish-0002",
"run_thread_id": 923023514,
"source_threads": [
{
"id": 809222460,
"theme_id": 520942414,
"client_id": "comment-resolved-0003",
"n": 3,
"page_url": "/home",
"author_name": "Rep Acme"
},
{
"id": 923023514,
"theme_id": 520942414,
"client_id": "comment-open-0001",
"n": 1,
"page_url": "/home/shop",
"author_name": "Admin Acme"
}
],
"status": "review",
"status_editable": true,
"tags": [],
"title": "Add customer videos",
"updated_at": "2026-11-12T17:52:36Z"
},
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:52:36Z"
}
}{
"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"
}
}