Company site hosting
Build a company site on Fluid
Builds a company site from its source on Fluid, so no Node is needed on the caller’s machine, and publishes the result. Send the project’s source files inline (files) or a ref of the site’s own repo (ref). Fluid queues the build and answers 202 at once; an isolated box then finds the framework (Vite, Astro, Next.js static export and the others fluid deploy knows, or plain HTML), installs with the project’s package manager (npm, pnpm or Yarn; Bun projects install with npm), runs its build script and publishes the output as a bundle through the same checks as the bundles routes. Read the build until it is succeeded, with the site’s url, or failed, with why and its log.
A box may reach only the npm and Yarn registries, Fluid’s API and the storage host uploads go to, and runs for at most 15 minutes. A site has one build going at a time and a company three.
Needs application_themes.update and a signed-in admin. A member’s site is refused with 404, as a site an admin may not edit. It answers 404 for every caller that passes those checks until the sites gateway is released to the company. A droplet installation token and an OAuth client token are refused with 403. Where builds are not set up yet the answer is 422 with details.error builds_not_configured: build locally and start a bundle instead.
POST
/
api
/
company
/
v2026-10
/
member-sites
/
{id}
/
builds
Build a company site on Fluid
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/builds \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"files": {
"package.json": {
"content": "{\"scripts\":{\"build\":\"vite build\"},\"devDependencies\":{\"vite\":\"^6.0.0\"}}"
},
"index.html": {
"content": "<div id=\"app\"></div><script type=\"module\" src=\"/src/main.ts\"></script>"
},
"src/main.ts": {
"content": "document.querySelector('#app').textContent = 'Hello'"
}
}
}
EOFimport requests
url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/builds"
payload = { "files": {
"package.json": { "content": "{\"scripts\":{\"build\":\"vite build\"},\"devDependencies\":{\"vite\":\"^6.0.0\"}}" },
"index.html": { "content": "<div id=\"app\"></div><script type=\"module\" src=\"/src/main.ts\"></script>" },
"src/main.ts": { "content": "document.querySelector('#app').textContent = 'Hello'" }
} }
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({
files: {
'package.json': {
content: '{"scripts":{"build":"vite build"},"devDependencies":{"vite":"^6.0.0"}}'
},
'index.html': {
content: '<div id="app"></div><script type="module" src="/src/main.ts"></script>'
},
'src/main.ts': {content: 'document.querySelector(\'#app\').textContent = \'Hello\''}
}
})
};
fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/builds', 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/company/v2026-10/member-sites/{id}/builds",
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([
'files' => [
'package.json' => [
'content' => '{"scripts":{"build":"vite build"},"devDependencies":{"vite":"^6.0.0"}}'
],
'index.html' => [
'content' => '<div id="app"></div><script type="module" src="/src/main.ts"></script>'
],
'src/main.ts' => [
'content' => 'document.querySelector(\'#app\').textContent = \'Hello\''
]
]
]),
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/company/v2026-10/member-sites/{id}/builds"
payload := strings.NewReader("{\n \"files\": {\n \"package.json\": {\n \"content\": \"{\\\"scripts\\\":{\\\"build\\\":\\\"vite build\\\"},\\\"devDependencies\\\":{\\\"vite\\\":\\\"^6.0.0\\\"}}\"\n },\n \"index.html\": {\n \"content\": \"<div id=\\\"app\\\"></div><script type=\\\"module\\\" src=\\\"/src/main.ts\\\"></script>\"\n },\n \"src/main.ts\": {\n \"content\": \"document.querySelector('#app').textContent = 'Hello'\"\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/company/v2026-10/member-sites/{id}/builds")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"files\": {\n \"package.json\": {\n \"content\": \"{\\\"scripts\\\":{\\\"build\\\":\\\"vite build\\\"},\\\"devDependencies\\\":{\\\"vite\\\":\\\"^6.0.0\\\"}}\"\n },\n \"index.html\": {\n \"content\": \"<div id=\\\"app\\\"></div><script type=\\\"module\\\" src=\\\"/src/main.ts\\\"></script>\"\n },\n \"src/main.ts\": {\n \"content\": \"document.querySelector('#app').textContent = 'Hello'\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/builds")
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 \"files\": {\n \"package.json\": {\n \"content\": \"{\\\"scripts\\\":{\\\"build\\\":\\\"vite build\\\"},\\\"devDependencies\\\":{\\\"vite\\\":\\\"^6.0.0\\\"}}\"\n },\n \"index.html\": {\n \"content\": \"<div id=\\\"app\\\"></div><script type=\\\"module\\\" src=\\\"/src/main.ts\\\"></script>\"\n },\n \"src/main.ts\": {\n \"content\": \"document.querySelector('#app').textContent = 'Hello'\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"member_site_build": {
"id": "0199537f-0000-7000-8000-000000000009",
"status": "queued",
"source": "upload",
"ref": null,
"commitSha": null,
"framework": null,
"bundleId": null,
"url": null,
"failure": null,
"createdAt": "2026-11-10T10:00:00.000Z",
"startedAt": null,
"finishedAt": null,
"deadlineAt": null,
"logs": []
},
"status": 202,
"meta": {
"request_uuid": "3b8f1d27-6c4e-4a91-8e5d-2f7c9a1b0e64",
"timestamp": "2026-11-10T10:00:00Z"
}
}{}{}{
"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": "Builds on Fluid aren't set up here yet; build locally and deploy the built files",
"details": {
"error": "builds_not_configured"
}
},
"status": 422,
"meta": {
"request_uuid": "3b8f1d27-6c4e-4a91-8e5d-2f7c9a1b0e64",
"timestamp": "2026-11-10T10:00:00Z"
}
}Authorizations
A company admin credential for your company, or a droplet installation token with the website scope for reads, except on the share routes, which refuse a droplet token.
Path Parameters
The site's id.
Body
application/json
The source of a build. Send exactly one of files and ref.
The project's source files by path inside the project, such as package.json or src/main.ts, at most 1,000 files and 10 MiB in all. Leave out node_modules and .git. The project needs a package.json with a build script, or an index.html, at its root.
Show child attributes
Show child attributes
A branch, tag or commit of the site's own repo to build instead.
Required string length:
1 - 255Response
The queued build.
One build of a site.
One build of a site on Fluid. It is queued, runs in an isolated box that installs and builds the project, and ends succeeded with the bundle it published or failed with why.
Show child attributes
Show child attributes
The HTTP status.
Response metadata included on every response body.
Show child attributes
Show child attributes
⌘I
Build a company site on Fluid
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/member-sites/{id}/builds \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"files": {
"package.json": {
"content": "{\"scripts\":{\"build\":\"vite build\"},\"devDependencies\":{\"vite\":\"^6.0.0\"}}"
},
"index.html": {
"content": "<div id=\"app\"></div><script type=\"module\" src=\"/src/main.ts\"></script>"
},
"src/main.ts": {
"content": "document.querySelector('#app').textContent = 'Hello'"
}
}
}
EOFimport requests
url = "https://api.fluid.app/api/company/v2026-10/member-sites/{id}/builds"
payload = { "files": {
"package.json": { "content": "{\"scripts\":{\"build\":\"vite build\"},\"devDependencies\":{\"vite\":\"^6.0.0\"}}" },
"index.html": { "content": "<div id=\"app\"></div><script type=\"module\" src=\"/src/main.ts\"></script>" },
"src/main.ts": { "content": "document.querySelector('#app').textContent = 'Hello'" }
} }
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({
files: {
'package.json': {
content: '{"scripts":{"build":"vite build"},"devDependencies":{"vite":"^6.0.0"}}'
},
'index.html': {
content: '<div id="app"></div><script type="module" src="/src/main.ts"></script>'
},
'src/main.ts': {content: 'document.querySelector(\'#app\').textContent = \'Hello\''}
}
})
};
fetch('https://api.fluid.app/api/company/v2026-10/member-sites/{id}/builds', 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/company/v2026-10/member-sites/{id}/builds",
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([
'files' => [
'package.json' => [
'content' => '{"scripts":{"build":"vite build"},"devDependencies":{"vite":"^6.0.0"}}'
],
'index.html' => [
'content' => '<div id="app"></div><script type="module" src="/src/main.ts"></script>'
],
'src/main.ts' => [
'content' => 'document.querySelector(\'#app\').textContent = \'Hello\''
]
]
]),
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/company/v2026-10/member-sites/{id}/builds"
payload := strings.NewReader("{\n \"files\": {\n \"package.json\": {\n \"content\": \"{\\\"scripts\\\":{\\\"build\\\":\\\"vite build\\\"},\\\"devDependencies\\\":{\\\"vite\\\":\\\"^6.0.0\\\"}}\"\n },\n \"index.html\": {\n \"content\": \"<div id=\\\"app\\\"></div><script type=\\\"module\\\" src=\\\"/src/main.ts\\\"></script>\"\n },\n \"src/main.ts\": {\n \"content\": \"document.querySelector('#app').textContent = 'Hello'\"\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/company/v2026-10/member-sites/{id}/builds")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"files\": {\n \"package.json\": {\n \"content\": \"{\\\"scripts\\\":{\\\"build\\\":\\\"vite build\\\"},\\\"devDependencies\\\":{\\\"vite\\\":\\\"^6.0.0\\\"}}\"\n },\n \"index.html\": {\n \"content\": \"<div id=\\\"app\\\"></div><script type=\\\"module\\\" src=\\\"/src/main.ts\\\"></script>\"\n },\n \"src/main.ts\": {\n \"content\": \"document.querySelector('#app').textContent = 'Hello'\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/member-sites/{id}/builds")
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 \"files\": {\n \"package.json\": {\n \"content\": \"{\\\"scripts\\\":{\\\"build\\\":\\\"vite build\\\"},\\\"devDependencies\\\":{\\\"vite\\\":\\\"^6.0.0\\\"}}\"\n },\n \"index.html\": {\n \"content\": \"<div id=\\\"app\\\"></div><script type=\\\"module\\\" src=\\\"/src/main.ts\\\"></script>\"\n },\n \"src/main.ts\": {\n \"content\": \"document.querySelector('#app').textContent = 'Hello'\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"member_site_build": {
"id": "0199537f-0000-7000-8000-000000000009",
"status": "queued",
"source": "upload",
"ref": null,
"commitSha": null,
"framework": null,
"bundleId": null,
"url": null,
"failure": null,
"createdAt": "2026-11-10T10:00:00.000Z",
"startedAt": null,
"finishedAt": null,
"deadlineAt": null,
"logs": []
},
"status": 202,
"meta": {
"request_uuid": "3b8f1d27-6c4e-4a91-8e5d-2f7c9a1b0e64",
"timestamp": "2026-11-10T10:00:00Z"
}
}{}{}{
"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": "Builds on Fluid aren't set up here yet; build locally and deploy the built files",
"details": {
"error": "builds_not_configured"
}
},
"status": 422,
"meta": {
"request_uuid": "3b8f1d27-6c4e-4a91-8e5d-2f7c9a1b0e64",
"timestamp": "2026-11-10T10:00:00Z"
}
}