Declares work to run on a schedule: an ordered list of named steps, each an
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": {},
"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": {},
"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: {},
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' => [
],
'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 \"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 \"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 \"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": {},
"input": {},
"key": "<string>",
"name": "<string>",
"result_path": "<string>",
"script": "<string>"
}
],
"timezone": "<string>",
"workstream": "<string>"
}{
"code": "not_found",
"details": {},
"message": "<string>"
}API Reference
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 previously declared under the same name; enabled false removes it.
REST only, with no MCP write tool, and the asymmetry is the point. 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 one than it was given — which is exactly what moving scope out of prose was for.
PUT
/
v1
/
scheduled-actions
Declares work to run on a schedule: an ordered list of named steps, each an
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": {},
"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": {},
"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: {},
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' => [
],
'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 \"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 \"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 \"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": {},
"input": {},
"key": "<string>",
"name": "<string>",
"result_path": "<string>",
"script": "<string>"
}
],
"timezone": "<string>",
"workstream": "<string>"
}{
"code": "not_found",
"details": {},
"message": "<string>"
}Authorizations
An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).
Body
application/json
declaration whose steps act rather than report.
Show child attributes
Show child attributes
run several without either replacing the other. Lowercase letters, digits, hyphens and underscores.
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.
at eight.
under its name for the steps that follow.
Show child attributes
Show child attributes
"America/New_York". Defaults to UTC. It matters for anything comparing against a provider's own day boundary: an ad account reports yesterday in the account's timezone, and a run at 08:00 UTC is the previous afternoon in Miami.
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
declaration whose steps act rather than report.
Show child attributes
Show child attributes
history can be inspected through the automation surfaces.
Show child attributes
Show child attributes