Agency requests
Give the agency's people access to the company's store
Requires a company-admin user session with multiplayer_tasks.execute, the company’s COWORK feature flag, and users.update (the permission to add admins). The caller can give only a role whose permissions they hold, as the admin invite checks; a root admin gives freely. Fluid never gives this access: only the customer does, from the ticket. The access lasts while the ticket’s request is open, at any stage and through every round of changes, and ends when the request closes (done or declined), is withdrawn or switched to another agency, when the agency is deleted, when the person leaves the agency, or when the customer takes it away (DELETE /agency-request/access/{user_id}). Each person must be a kept member of the request’s agency. A person is made an admin of the company holding the role. A person who already holds an admin of their own, which this access did not make, keeps it exactly as it is and is given nothing: they had access. A person whose admin another open request’s grant keeps gets this request’s grant too and keeps the role they hold. A person whose admin carries a ticket seat mark, live or ended (a pickup owner’s messaging-only seat), keeps that admin: it is restored if it ended, loses the mark and holds the role in place of the seat’s role, and the person stays in the ticket’s channel as an admin. When the access ends, the admin goes back to being a seat, so a pickup owner whose request is still open stays in the channel. The whole call is refused, and nothing is written, when any person is not a kept member of the agency (not_an_agency_member) or cannot be made an admin (enrolment_failed), or the request has closed; holding a ticket seat is never a reason to refuse. The request is not written: no event, no new version. Giving access again to a person who has it answers 200 with the task as it is. Without role_id, the company’s role named Developer is used; a company without one answers 422 role_required.
POST
/
api
/
v202604
/
multiplayer
/
tasks
/
{id}
/
agency-request
/
access
Give the agency's people access to the company's store
curl --request POST \
--url https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/agency-request/access \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"access": {
"user_ids": [
4120
],
"role_id": 9
}
}
'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/agency-request/access"
payload = { "access": {
"user_ids": [4120],
"role_id": 9
} }
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({access: {user_ids: [4120], role_id: 9}})
};
fetch('https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/agency-request/access', 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}/agency-request/access",
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([
'access' => [
'user_ids' => [
4120
],
'role_id' => 9
]
]),
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}/agency-request/access"
payload := strings.NewReader("{\n \"access\": {\n \"user_ids\": [\n 4120\n ],\n \"role_id\": 9\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}/agency-request/access")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"access\": {\n \"user_ids\": [\n 4120\n ],\n \"role_id\": 9\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/agency-request/access")
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 \"access\": {\n \"user_ids\": [\n 4120\n ],\n \"role_id\": 9\n }\n}"
response = http.request(request)
puts response.read_body{
"task": {
"id": "01a1d0e3-1d4d-76a0-9b7a-63ae6deddb0d",
"agency": {
"key": "fluid_studios",
"name": "Test agency"
},
"agency_join_request": null,
"agency_request": {
"agency": {
"key": "fluid_studios",
"name": "Test agency"
},
"state": "sent",
"stage": "requested",
"version": 0,
"sent_at": "2026-11-12T17:51:47.534Z",
"quote": null,
"last_step": null,
"revised_quote": null,
"changes_round": 0,
"reopenable_until": null,
"delivery_overdue": false,
"owner": {
"id": "287253845",
"name": "Gloria Baxter"
},
"access": [
{
"person": {
"id": "287253845",
"name": "Gloria Baxter"
},
"role": {
"id": 965134678,
"name": "Developer"
}
}
],
"owner_has_access": true
},
"assignee": null,
"assigner": null,
"board_position": null,
"board_position_at_ms": null,
"category": null,
"client_id": "access-152872",
"company_id": 96778814,
"conversation_id": null,
"created_at": "2026-11-12T17:51:47Z",
"creator_id": 433400890,
"description": "",
"due_on": null,
"kind": null,
"lock_version": 1,
"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": false,
"tags": [],
"title": "access-152872",
"updated_at": "2026-11-12T17:51:47Z"
},
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:51:47Z"
}
}{
"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"
}
}{
"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
The agency people to give access to the company's store, and the role they hold.
Show child attributes
Show child attributes
⌘I
Give the agency's people access to the company's store
curl --request POST \
--url https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/agency-request/access \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"access": {
"user_ids": [
4120
],
"role_id": 9
}
}
'import requests
url = "https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/agency-request/access"
payload = { "access": {
"user_ids": [4120],
"role_id": 9
} }
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({access: {user_ids: [4120], role_id: 9}})
};
fetch('https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/agency-request/access', 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}/agency-request/access",
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([
'access' => [
'user_ids' => [
4120
],
'role_id' => 9
]
]),
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}/agency-request/access"
payload := strings.NewReader("{\n \"access\": {\n \"user_ids\": [\n 4120\n ],\n \"role_id\": 9\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}/agency-request/access")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"access\": {\n \"user_ids\": [\n 4120\n ],\n \"role_id\": 9\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/multiplayer/tasks/{id}/agency-request/access")
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 \"access\": {\n \"user_ids\": [\n 4120\n ],\n \"role_id\": 9\n }\n}"
response = http.request(request)
puts response.read_body{
"task": {
"id": "01a1d0e3-1d4d-76a0-9b7a-63ae6deddb0d",
"agency": {
"key": "fluid_studios",
"name": "Test agency"
},
"agency_join_request": null,
"agency_request": {
"agency": {
"key": "fluid_studios",
"name": "Test agency"
},
"state": "sent",
"stage": "requested",
"version": 0,
"sent_at": "2026-11-12T17:51:47.534Z",
"quote": null,
"last_step": null,
"revised_quote": null,
"changes_round": 0,
"reopenable_until": null,
"delivery_overdue": false,
"owner": {
"id": "287253845",
"name": "Gloria Baxter"
},
"access": [
{
"person": {
"id": "287253845",
"name": "Gloria Baxter"
},
"role": {
"id": 965134678,
"name": "Developer"
}
}
],
"owner_has_access": true
},
"assignee": null,
"assigner": null,
"board_position": null,
"board_position_at_ms": null,
"category": null,
"client_id": "access-152872",
"company_id": 96778814,
"conversation_id": null,
"created_at": "2026-11-12T17:51:47Z",
"creator_id": 433400890,
"description": "",
"due_on": null,
"kind": null,
"lock_version": 1,
"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": false,
"tags": [],
"title": "access-152872",
"updated_at": "2026-11-12T17:51:47Z"
},
"status": 200,
"meta": {
"request_uuid": null,
"timestamp": "2026-11-12T17:51:47Z"
}
}{
"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"
}
}{
"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"
}
}