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,
  "name": "<string>",
  "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,
    "name": "<string>",
    "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,
    name: '<string>',
    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,
    'name' => '<string>',
    '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  \"name\": \"<string>\",\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  \"name\": \"<string>\",\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  \"name\": \"<string>\",\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,
  "job_id": "<string>",
  "name": "<string>",
  "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

scheduled-actions

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,
  "name": "<string>",
  "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,
    "name": "<string>",
    "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,
    name: '<string>',
    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,
    'name' => '<string>',
    '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  \"name\": \"<string>\",\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  \"name\": \"<string>\",\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  \"name\": \"<string>\",\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,
  "job_id": "<string>",
  "name": "<string>",
  "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

Authorization

string

header

required

An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

Body

application/json

destination

Where to record what a run produced. Omitting a destination is normal for a · object

declaration whose steps act rather than report.

Show child attributes

enabled

boolean

name

string

run several without either replacing the other. Lowercase letters, digits, hyphens and underscores.

schedule

string

at eight.

steps

One step of a scheduled declaration. A step is EITHER an action to invoke · object[]

under its name for the steps that follow.

Show child attributes

timezone

string

"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.

workstream

string

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

destination

Where to record what a run produced. Omitting a destination is normal for a · object

declaration whose steps act rather than report.

Show child attributes

enabled

boolean

job_id

string

history can be inspected through the automation surfaces.

name

string

schedule

string

steps

One step of a scheduled declaration. A step is EITHER an action to invoke · object[]

Show child attributes

timezone

string

workstream

string

Lists what an organization has declared to run on a schedule: each ScreenshotAPI mirrors the erdo_screenshot MCP tool as a REST endpoint: capture

Platform API

API Reference

Build apps

Python SDK

TypeScript SDK

Declares work to run on a schedule: an ordered list of named steps, each an

Authorizations

Body

Response