AI bots
Schedule recurring work with a bot
Ask a bot to do something on a schedule, from your direct conversation with it: each firing starts a run that follows your instructions and posts the result back into that conversation. The run acts for the bot’s owner and holds the owner’s permissions, as a reply to your message there does. The conversation must be yours with the bot alone. You can have at most 10 schedules with one bot, each firing at most once every 15 minutes.
A bot’s run may call this with the login it holds and name itself in X-Fluid-Bot-Id, to set up what a person asked it for in their direct conversation.
Needs the messaging.update permission.
POST
/
api
/
company
/
v2026-10
/
bots
/
{bot_id}
/
direct-conversation
/
schedules
Schedule recurring work with a bot
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/bots/{bot_id}/direct-conversation/schedules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"schedule": {
"name": "Monday sales recap",
"instructions": "Summarize my team's sales from last week and flag anyone who hasn't ordered.",
"cron": "0 9 * * 1",
"timezone": "America/Denver"
}
}
EOFimport requests
url = "https://api.fluid.app/api/company/v2026-10/bots/{bot_id}/direct-conversation/schedules"
payload = { "schedule": {
"name": "Monday sales recap",
"instructions": "Summarize my team's sales from last week and flag anyone who hasn't ordered.",
"cron": "0 9 * * 1",
"timezone": "America/Denver"
} }
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({
schedule: {
name: 'Monday sales recap',
instructions: 'Summarize my team\'s sales from last week and flag anyone who hasn\'t ordered.',
cron: '0 9 * * 1',
timezone: 'America/Denver'
}
})
};
fetch('https://api.fluid.app/api/company/v2026-10/bots/{bot_id}/direct-conversation/schedules', 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/bots/{bot_id}/direct-conversation/schedules",
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([
'schedule' => [
'name' => 'Monday sales recap',
'instructions' => 'Summarize my team\'s sales from last week and flag anyone who hasn\'t ordered.',
'cron' => '0 9 * * 1',
'timezone' => 'America/Denver'
]
]),
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/bots/{bot_id}/direct-conversation/schedules"
payload := strings.NewReader("{\n \"schedule\": {\n \"name\": \"Monday sales recap\",\n \"instructions\": \"Summarize my team's sales from last week and flag anyone who hasn't ordered.\",\n \"cron\": \"0 9 * * 1\",\n \"timezone\": \"America/Denver\"\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/bots/{bot_id}/direct-conversation/schedules")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"schedule\": {\n \"name\": \"Monday sales recap\",\n \"instructions\": \"Summarize my team's sales from last week and flag anyone who hasn't ordered.\",\n \"cron\": \"0 9 * * 1\",\n \"timezone\": \"America/Denver\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/bots/{bot_id}/direct-conversation/schedules")
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 \"schedule\": {\n \"name\": \"Monday sales recap\",\n \"instructions\": \"Summarize my team's sales from last week and flag anyone who hasn't ordered.\",\n \"cron\": \"0 9 * * 1\",\n \"timezone\": \"America/Denver\"\n }\n}"
response = http.request(request)
puts response.read_body{
"schedule": {
"id": "019a0b1c-2d3e-7f40-8a51-6b7c8d9e0f20",
"bot_id": "0192f3c4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
"conversation_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61",
"name": "Monday sales recap",
"instructions": "Summarize my team's sales from last week and flag anyone who hasn't ordered.",
"schedule": {
"cron": "0 9 * * 1",
"timezone": "America/Denver"
},
"next_run_at": "2026-11-23T16:02:17.000Z",
"last_run_at": null,
"enabled": true,
"created_by": {
"id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a70",
"name": "Casey Brooks"
},
"lock_version": 0,
"created_at": "2026-11-21T15:35:00.000Z",
"updated_at": "2026-11-21T15:35:00.000Z"
},
"status": 201,
"meta": {
"request_uuid": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-11-21T15:35:00Z"
}
}{
"message": "Invalid credentials."
}{
"message": "Not authorized."
}{
"error": {
"message": "Direct conversation with this bot not found",
"details": {
"type": "no_direct_conversation"
}
},
"status": 404,
"meta": {
"request_uuid": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-11-21T15:32:08Z"
}
}{
"error": {
"message": "A schedule fires at most once every 15 minutes",
"details": {
"cron": [
"fires less than 15 minutes apart"
],
"type": "schedule_too_frequent"
}
},
"status": 422,
"meta": {
"request_uuid": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-11-21T15:35:00Z"
}
}Authorizations
Response
The new schedule.
⌘I
Schedule recurring work with a bot
curl --request POST \
--url https://api.fluid.app/api/company/v2026-10/bots/{bot_id}/direct-conversation/schedules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"schedule": {
"name": "Monday sales recap",
"instructions": "Summarize my team's sales from last week and flag anyone who hasn't ordered.",
"cron": "0 9 * * 1",
"timezone": "America/Denver"
}
}
EOFimport requests
url = "https://api.fluid.app/api/company/v2026-10/bots/{bot_id}/direct-conversation/schedules"
payload = { "schedule": {
"name": "Monday sales recap",
"instructions": "Summarize my team's sales from last week and flag anyone who hasn't ordered.",
"cron": "0 9 * * 1",
"timezone": "America/Denver"
} }
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({
schedule: {
name: 'Monday sales recap',
instructions: 'Summarize my team\'s sales from last week and flag anyone who hasn\'t ordered.',
cron: '0 9 * * 1',
timezone: 'America/Denver'
}
})
};
fetch('https://api.fluid.app/api/company/v2026-10/bots/{bot_id}/direct-conversation/schedules', 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/bots/{bot_id}/direct-conversation/schedules",
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([
'schedule' => [
'name' => 'Monday sales recap',
'instructions' => 'Summarize my team\'s sales from last week and flag anyone who hasn\'t ordered.',
'cron' => '0 9 * * 1',
'timezone' => 'America/Denver'
]
]),
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/bots/{bot_id}/direct-conversation/schedules"
payload := strings.NewReader("{\n \"schedule\": {\n \"name\": \"Monday sales recap\",\n \"instructions\": \"Summarize my team's sales from last week and flag anyone who hasn't ordered.\",\n \"cron\": \"0 9 * * 1\",\n \"timezone\": \"America/Denver\"\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/bots/{bot_id}/direct-conversation/schedules")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"schedule\": {\n \"name\": \"Monday sales recap\",\n \"instructions\": \"Summarize my team's sales from last week and flag anyone who hasn't ordered.\",\n \"cron\": \"0 9 * * 1\",\n \"timezone\": \"America/Denver\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/company/v2026-10/bots/{bot_id}/direct-conversation/schedules")
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 \"schedule\": {\n \"name\": \"Monday sales recap\",\n \"instructions\": \"Summarize my team's sales from last week and flag anyone who hasn't ordered.\",\n \"cron\": \"0 9 * * 1\",\n \"timezone\": \"America/Denver\"\n }\n}"
response = http.request(request)
puts response.read_body{
"schedule": {
"id": "019a0b1c-2d3e-7f40-8a51-6b7c8d9e0f20",
"bot_id": "0192f3c4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
"conversation_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a61",
"name": "Monday sales recap",
"instructions": "Summarize my team's sales from last week and flag anyone who hasn't ordered.",
"schedule": {
"cron": "0 9 * * 1",
"timezone": "America/Denver"
},
"next_run_at": "2026-11-23T16:02:17.000Z",
"last_run_at": null,
"enabled": true,
"created_by": {
"id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a70",
"name": "Casey Brooks"
},
"lock_version": 0,
"created_at": "2026-11-21T15:35:00.000Z",
"updated_at": "2026-11-21T15:35:00.000Z"
},
"status": 201,
"meta": {
"request_uuid": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-11-21T15:35:00Z"
}
}{
"message": "Invalid credentials."
}{
"message": "Not authorized."
}{
"error": {
"message": "Direct conversation with this bot not found",
"details": {
"type": "no_direct_conversation"
}
},
"status": 404,
"meta": {
"request_uuid": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-11-21T15:32:08Z"
}
}{
"error": {
"message": "A schedule fires at most once every 15 minutes",
"details": {
"cron": [
"fires less than 15 minutes apart"
],
"type": "schedule_too_frequent"
}
},
"status": 422,
"meta": {
"request_uuid": "7e2c9b41-3f8a-4d15-b6e0-9a4c21d7f583",
"timestamp": "2026-11-21T15:35:00Z"
}
}