Installations
Install a droplet
Installs a droplet for your company and calls its install webhook. You can install a published droplet, one your company publishes, or an internal droplet granted to you.
The droplet receives the scopes it requests unless you narrow them with installation.scopes.
Needs the droplets.update permission.
POST
/
api
/
company
/
v2026-10
/
droplets
/
{droplet_uuid}
/
installations
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/droplets/{droplet_uuid}/installations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"droplet_installation": {
"uuid": "dri_7Hc2kWq9mNz4pLx8",
"droplet_uuid": "drp_4tq8nxw2kfl9mrv3bpz6cyh1jds7age5",
"status": "active",
"scopes": [
"orders"
],
"effective_scopes": [
"orders"
],
"created_at": "2026-10-18T15:32:08Z"
},
"status": 201,
"meta": {
"request_id": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-10-18T15:32:08Z"
}
}{
"message": "Invalid credentials."
}{
"message": "Not authorized."
}{
"error": {
"message": "Droplet not found",
"details": {}
},
"status": 404,
"meta": {
"request_id": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-10-18T15:32:08Z"
}
}{
"error": {
"message": "Droplet already installed",
"details": {}
},
"status": 409,
"meta": {
"request_id": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-10-18T15:32:08Z"
}
}{
"error": {
"message": "Role not found",
"details": {
"role_id": [
"not found"
]
}
},
"status": 422,
"meta": {
"request_id": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-10-18T15:32:08Z"
}
}Authorizations
A company admin credential for your company. Droplet installation tokens are refused.
Path Parameters
The droplet's uuid, from uuid on any droplet.
Body
application/json
Show child attributes
Show child attributes
⌘I
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/droplets/{droplet_uuid}/installations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"droplet_installation": {
"uuid": "dri_7Hc2kWq9mNz4pLx8",
"droplet_uuid": "drp_4tq8nxw2kfl9mrv3bpz6cyh1jds7age5",
"status": "active",
"scopes": [
"orders"
],
"effective_scopes": [
"orders"
],
"created_at": "2026-10-18T15:32:08Z"
},
"status": 201,
"meta": {
"request_id": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-10-18T15:32:08Z"
}
}{
"message": "Invalid credentials."
}{
"message": "Not authorized."
}{
"error": {
"message": "Droplet not found",
"details": {}
},
"status": 404,
"meta": {
"request_id": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-10-18T15:32:08Z"
}
}{
"error": {
"message": "Droplet already installed",
"details": {}
},
"status": 409,
"meta": {
"request_id": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-10-18T15:32:08Z"
}
}{
"error": {
"message": "Role not found",
"details": {
"role_id": [
"not found"
]
}
},
"status": 422,
"meta": {
"request_id": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-10-18T15:32:08Z"
}
}