curl --request PUT \
--url https://api.erdo.ai/v1/scheduled-actions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"destination": {
"columns": {},
"dataset": "<string>",
"key_column": "<string>"
},
"enabled": true,
"ends_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"run_at": "2023-11-07T05:31:56Z",
"schedule": "<string>",
"steps": [
{
"app": "<string>",
"for_each": [
"<unknown>"
],
"input": {},
"key": "<string>",
"name": "<string>",
"result_path": "<string>",
"script": "<string>"
}
],
"timezone": "<string>",
"workstream": "<string>"
}
'import requests
url = "https://api.erdo.ai/v1/scheduled-actions"
payload = {
"destination": {
"columns": {},
"dataset": "<string>",
"key_column": "<string>"
},
"enabled": True,
"ends_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"run_at": "2023-11-07T05:31:56Z",
"schedule": "<string>",
"steps": [
{
"app": "<string>",
"for_each": ["<unknown>"],
"input": {},
"key": "<string>",
"name": "<string>",
"result_path": "<string>",
"script": "<string>"
}
],
"timezone": "<string>",
"workstream": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
destination: {columns: {}, dataset: '<string>', key_column: '<string>'},
enabled: true,
ends_at: '2023-11-07T05:31:56Z',
name: '<string>',
run_at: '2023-11-07T05:31:56Z',
schedule: '<string>',
steps: [
{
app: '<string>',
for_each: ['<unknown>'],
input: {},
key: '<string>',
name: '<string>',
result_path: '<string>',
script: '<string>'
}
],
timezone: '<string>',
workstream: '<string>'
})
};
fetch('https://api.erdo.ai/v1/scheduled-actions', 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.erdo.ai/v1/scheduled-actions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'destination' => [
'columns' => [
],
'dataset' => '<string>',
'key_column' => '<string>'
],
'enabled' => true,
'ends_at' => '2023-11-07T05:31:56Z',
'name' => '<string>',
'run_at' => '2023-11-07T05:31:56Z',
'schedule' => '<string>',
'steps' => [
[
'app' => '<string>',
'for_each' => [
'<unknown>'
],
'input' => [
],
'key' => '<string>',
'name' => '<string>',
'result_path' => '<string>',
'script' => '<string>'
]
],
'timezone' => '<string>',
'workstream' => '<string>'
]),
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.erdo.ai/v1/scheduled-actions"
payload := strings.NewReader("{\n \"destination\": {\n \"columns\": {},\n \"dataset\": \"<string>\",\n \"key_column\": \"<string>\"\n },\n \"enabled\": true,\n \"ends_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"run_at\": \"2023-11-07T05:31:56Z\",\n \"schedule\": \"<string>\",\n \"steps\": [\n {\n \"app\": \"<string>\",\n \"for_each\": [\n \"<unknown>\"\n ],\n \"input\": {},\n \"key\": \"<string>\",\n \"name\": \"<string>\",\n \"result_path\": \"<string>\",\n \"script\": \"<string>\"\n }\n ],\n \"timezone\": \"<string>\",\n \"workstream\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.erdo.ai/v1/scheduled-actions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"destination\": {\n \"columns\": {},\n \"dataset\": \"<string>\",\n \"key_column\": \"<string>\"\n },\n \"enabled\": true,\n \"ends_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"run_at\": \"2023-11-07T05:31:56Z\",\n \"schedule\": \"<string>\",\n \"steps\": [\n {\n \"app\": \"<string>\",\n \"for_each\": [\n \"<unknown>\"\n ],\n \"input\": {},\n \"key\": \"<string>\",\n \"name\": \"<string>\",\n \"result_path\": \"<string>\",\n \"script\": \"<string>\"\n }\n ],\n \"timezone\": \"<string>\",\n \"workstream\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.erdo.ai/v1/scheduled-actions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"destination\": {\n \"columns\": {},\n \"dataset\": \"<string>\",\n \"key_column\": \"<string>\"\n },\n \"enabled\": true,\n \"ends_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"run_at\": \"2023-11-07T05:31:56Z\",\n \"schedule\": \"<string>\",\n \"steps\": [\n {\n \"app\": \"<string>\",\n \"for_each\": [\n \"<unknown>\"\n ],\n \"input\": {},\n \"key\": \"<string>\",\n \"name\": \"<string>\",\n \"result_path\": \"<string>\",\n \"script\": \"<string>\"\n }\n ],\n \"timezone\": \"<string>\",\n \"workstream\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"destination": {
"columns": {},
"dataset": "<string>",
"key_column": "<string>"
},
"enabled": true,
"ends_at": "2023-11-07T05:31:56Z",
"job_id": "<string>",
"name": "<string>",
"run_at": "2023-11-07T05:31:56Z",
"schedule": "<string>",
"steps": [
{
"app": "<string>",
"for_each": [
"<unknown>"
],
"input": {},
"key": "<string>",
"name": "<string>",
"result_path": "<string>",
"script": "<string>"
}
],
"timezone": "<string>",
"workstream": "<string>"
}{
"code": "not_found",
"details": {},
"message": "<string>"
}Declares work to run on a schedule: an ordered list of named steps, each an action to invoke or a
script to run, bounded by the provider objects a workstream governs. The declaration replaces whatever was declared under the same name; enabled false removes it. It is REST only with no MCP write tool, deliberately: the scope a run acts on is read from the workstream at run time, so an automation that could declare its own scheduled work could hand itself a wider scope than it was given.
curl --request PUT \
--url https://api.erdo.ai/v1/scheduled-actions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"destination": {
"columns": {},
"dataset": "<string>",
"key_column": "<string>"
},
"enabled": true,
"ends_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"run_at": "2023-11-07T05:31:56Z",
"schedule": "<string>",
"steps": [
{
"app": "<string>",
"for_each": [
"<unknown>"
],
"input": {},
"key": "<string>",
"name": "<string>",
"result_path": "<string>",
"script": "<string>"
}
],
"timezone": "<string>",
"workstream": "<string>"
}
'import requests
url = "https://api.erdo.ai/v1/scheduled-actions"
payload = {
"destination": {
"columns": {},
"dataset": "<string>",
"key_column": "<string>"
},
"enabled": True,
"ends_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"run_at": "2023-11-07T05:31:56Z",
"schedule": "<string>",
"steps": [
{
"app": "<string>",
"for_each": ["<unknown>"],
"input": {},
"key": "<string>",
"name": "<string>",
"result_path": "<string>",
"script": "<string>"
}
],
"timezone": "<string>",
"workstream": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
destination: {columns: {}, dataset: '<string>', key_column: '<string>'},
enabled: true,
ends_at: '2023-11-07T05:31:56Z',
name: '<string>',
run_at: '2023-11-07T05:31:56Z',
schedule: '<string>',
steps: [
{
app: '<string>',
for_each: ['<unknown>'],
input: {},
key: '<string>',
name: '<string>',
result_path: '<string>',
script: '<string>'
}
],
timezone: '<string>',
workstream: '<string>'
})
};
fetch('https://api.erdo.ai/v1/scheduled-actions', 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.erdo.ai/v1/scheduled-actions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'destination' => [
'columns' => [
],
'dataset' => '<string>',
'key_column' => '<string>'
],
'enabled' => true,
'ends_at' => '2023-11-07T05:31:56Z',
'name' => '<string>',
'run_at' => '2023-11-07T05:31:56Z',
'schedule' => '<string>',
'steps' => [
[
'app' => '<string>',
'for_each' => [
'<unknown>'
],
'input' => [
],
'key' => '<string>',
'name' => '<string>',
'result_path' => '<string>',
'script' => '<string>'
]
],
'timezone' => '<string>',
'workstream' => '<string>'
]),
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.erdo.ai/v1/scheduled-actions"
payload := strings.NewReader("{\n \"destination\": {\n \"columns\": {},\n \"dataset\": \"<string>\",\n \"key_column\": \"<string>\"\n },\n \"enabled\": true,\n \"ends_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"run_at\": \"2023-11-07T05:31:56Z\",\n \"schedule\": \"<string>\",\n \"steps\": [\n {\n \"app\": \"<string>\",\n \"for_each\": [\n \"<unknown>\"\n ],\n \"input\": {},\n \"key\": \"<string>\",\n \"name\": \"<string>\",\n \"result_path\": \"<string>\",\n \"script\": \"<string>\"\n }\n ],\n \"timezone\": \"<string>\",\n \"workstream\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.erdo.ai/v1/scheduled-actions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"destination\": {\n \"columns\": {},\n \"dataset\": \"<string>\",\n \"key_column\": \"<string>\"\n },\n \"enabled\": true,\n \"ends_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"run_at\": \"2023-11-07T05:31:56Z\",\n \"schedule\": \"<string>\",\n \"steps\": [\n {\n \"app\": \"<string>\",\n \"for_each\": [\n \"<unknown>\"\n ],\n \"input\": {},\n \"key\": \"<string>\",\n \"name\": \"<string>\",\n \"result_path\": \"<string>\",\n \"script\": \"<string>\"\n }\n ],\n \"timezone\": \"<string>\",\n \"workstream\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.erdo.ai/v1/scheduled-actions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"destination\": {\n \"columns\": {},\n \"dataset\": \"<string>\",\n \"key_column\": \"<string>\"\n },\n \"enabled\": true,\n \"ends_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"run_at\": \"2023-11-07T05:31:56Z\",\n \"schedule\": \"<string>\",\n \"steps\": [\n {\n \"app\": \"<string>\",\n \"for_each\": [\n \"<unknown>\"\n ],\n \"input\": {},\n \"key\": \"<string>\",\n \"name\": \"<string>\",\n \"result_path\": \"<string>\",\n \"script\": \"<string>\"\n }\n ],\n \"timezone\": \"<string>\",\n \"workstream\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"destination": {
"columns": {},
"dataset": "<string>",
"key_column": "<string>"
},
"enabled": true,
"ends_at": "2023-11-07T05:31:56Z",
"job_id": "<string>",
"name": "<string>",
"run_at": "2023-11-07T05:31:56Z",
"schedule": "<string>",
"steps": [
{
"app": "<string>",
"for_each": [
"<unknown>"
],
"input": {},
"key": "<string>",
"name": "<string>",
"result_path": "<string>",
"script": "<string>"
}
],
"timezone": "<string>",
"workstream": "<string>"
}{
"code": "not_found",
"details": {},
"message": "<string>"
}Authorizations
Body
after it, then the automation stops for good. It is the way to act once on a date; a daily declaration whose steps check the date pays for a run every day until then. ends_at stops a recurring schedule after an instant. Both are RFC3339 and live on the cron trigger the scheduler obeys; a save is a whole declaration, so omitting them clears them.
bound what this run may act on. The refs are read at run time and handed to the steps as {{scope.ids}} and {{scope.refs}}; nothing is copied here, so publishing a new set takes effect on the next run with no edit to this declaration.
A workstream governing nothing yet means a run that does nothing and says so — never a run with no filter. Omit this only for a declaration that genuinely acts on no provider objects.
Response
Success response

