Skip to main content
PUT
ConfigureDatasetRefreshAPI mirrors the erdo_configure_dataset_refresh MCP

Authorizations

Authorization
string
header
required

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

Path Parameters

datasetSlug
string
required

Body

application/json
agent_prompt
string
context_dataset_slugs
string[]
key_column
string
live_write_mode
string
parameters
object
payload_schema
object
refresh_mode
string
refresh_on_view_debounce_seconds
integer<int32>
Required range: -2147483648 <= x <= 2147483647
refresh_on_view_enabled
boolean
refresh_on_view_stale_after_seconds
integer<int32>
Required range: -2147483648 <= x <= 2147483647
sample_payload
object
schedule
string
script
string
script_entrypoint
string
strategy
string
timezone
string
transform_js
string

Response

Success response

dataset_id
string<uuid>
dataset_slug
string
job_id
string<uuid>
previous_strategy
string

configure.

refresh_config_id
string<uuid>
refresh_mode
string
schedule
string
strategy
string
test_run
DatasetRefreshTestRun reports the outcome of the one-off execution that runs · object

immediately after a deterministic refresh is installed. A configuration that saves cleanly and fails on its first real run is the failure mode this exists to catch, so the result travels back with the configure rather than waiting for the schedule to discover it.

webhook_secret
string
webhook_url
string

secret only ever here — the read path never returns it.