UpdatePageAPI mirrors the erdo_update_page MCP tool.
curl --request PUT \
--url https://api.erdo.ai/v1/pages/{pageID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"css": "<string>",
"dataset_slugs": [
"<string>"
],
"html": "<string>",
"js": "<string>",
"kv_slugs": [
"<string>"
],
"meta_description": "<string>",
"meta_icon_asset_id": "<string>",
"meta_image_asset_id": "<string>",
"meta_title": "<string>",
"page_id": "<string>",
"public": true,
"request_review": true,
"title": "<string>",
"writable_dataset_slugs": [
"<string>"
],
"writable_kv_slugs": [
"<string>"
]
}
'import requests
url = "https://api.erdo.ai/v1/pages/{pageID}"
payload = {
"css": "<string>",
"dataset_slugs": ["<string>"],
"html": "<string>",
"js": "<string>",
"kv_slugs": ["<string>"],
"meta_description": "<string>",
"meta_icon_asset_id": "<string>",
"meta_image_asset_id": "<string>",
"meta_title": "<string>",
"page_id": "<string>",
"public": True,
"request_review": True,
"title": "<string>",
"writable_dataset_slugs": ["<string>"],
"writable_kv_slugs": ["<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({
css: '<string>',
dataset_slugs: ['<string>'],
html: '<string>',
js: '<string>',
kv_slugs: ['<string>'],
meta_description: '<string>',
meta_icon_asset_id: '<string>',
meta_image_asset_id: '<string>',
meta_title: '<string>',
page_id: '<string>',
public: true,
request_review: true,
title: '<string>',
writable_dataset_slugs: ['<string>'],
writable_kv_slugs: ['<string>']
})
};
fetch('https://api.erdo.ai/v1/pages/{pageID}', 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/pages/{pageID}",
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([
'css' => '<string>',
'dataset_slugs' => [
'<string>'
],
'html' => '<string>',
'js' => '<string>',
'kv_slugs' => [
'<string>'
],
'meta_description' => '<string>',
'meta_icon_asset_id' => '<string>',
'meta_image_asset_id' => '<string>',
'meta_title' => '<string>',
'page_id' => '<string>',
'public' => true,
'request_review' => true,
'title' => '<string>',
'writable_dataset_slugs' => [
'<string>'
],
'writable_kv_slugs' => [
'<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/pages/{pageID}"
payload := strings.NewReader("{\n \"css\": \"<string>\",\n \"dataset_slugs\": [\n \"<string>\"\n ],\n \"html\": \"<string>\",\n \"js\": \"<string>\",\n \"kv_slugs\": [\n \"<string>\"\n ],\n \"meta_description\": \"<string>\",\n \"meta_icon_asset_id\": \"<string>\",\n \"meta_image_asset_id\": \"<string>\",\n \"meta_title\": \"<string>\",\n \"page_id\": \"<string>\",\n \"public\": true,\n \"request_review\": true,\n \"title\": \"<string>\",\n \"writable_dataset_slugs\": [\n \"<string>\"\n ],\n \"writable_kv_slugs\": [\n \"<string>\"\n ]\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/pages/{pageID}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"css\": \"<string>\",\n \"dataset_slugs\": [\n \"<string>\"\n ],\n \"html\": \"<string>\",\n \"js\": \"<string>\",\n \"kv_slugs\": [\n \"<string>\"\n ],\n \"meta_description\": \"<string>\",\n \"meta_icon_asset_id\": \"<string>\",\n \"meta_image_asset_id\": \"<string>\",\n \"meta_title\": \"<string>\",\n \"page_id\": \"<string>\",\n \"public\": true,\n \"request_review\": true,\n \"title\": \"<string>\",\n \"writable_dataset_slugs\": [\n \"<string>\"\n ],\n \"writable_kv_slugs\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.erdo.ai/v1/pages/{pageID}")
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 \"css\": \"<string>\",\n \"dataset_slugs\": [\n \"<string>\"\n ],\n \"html\": \"<string>\",\n \"js\": \"<string>\",\n \"kv_slugs\": [\n \"<string>\"\n ],\n \"meta_description\": \"<string>\",\n \"meta_icon_asset_id\": \"<string>\",\n \"meta_image_asset_id\": \"<string>\",\n \"meta_title\": \"<string>\",\n \"page_id\": \"<string>\",\n \"public\": true,\n \"request_review\": true,\n \"title\": \"<string>\",\n \"writable_dataset_slugs\": [\n \"<string>\"\n ],\n \"writable_kv_slugs\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"cloned_pipelines": [
{
"id": "<string>",
"purpose": "<string>",
"slug": "<string>",
"source_id": "<string>"
}
],
"id": "<string>",
"meta_description": "<string>",
"meta_icon_asset_id": "<string>",
"meta_image_asset_id": "<string>",
"meta_title": "<string>",
"notes": [
"<string>"
],
"public": true,
"public_url": "<string>",
"review": {
"issues": [
{
"category": "<string>",
"description": "<string>",
"id": "<string>",
"judge_slug": "<string>",
"severity": "<string>",
"suggestion": "<string>"
}
],
"judges": [
"<string>"
],
"lighthouse": {
"accessibility": 123,
"best_practices": 123,
"fetched_at": "2023-11-07T05:31:56Z",
"performance": 123,
"seo": 123
},
"reason": "<string>",
"reviewed": true,
"summary": "<string>"
},
"rewrites": {},
"source_page_id": "<string>",
"thread_id": "<string>",
"title": "<string>",
"url": "<string>",
"validation": {
"errors": [
{
"column": 123,
"context": "<string>",
"field": "<string>",
"line": 123,
"message": "<string>",
"severity": "<string>"
}
],
"valid": true
},
"warning": "<string>"
}{
"code": "not_found",
"details": {},
"message": "<string>"
}API Reference
UpdatePageAPI mirrors the erdo_update_page MCP tool.
PUT
/
v1
/
pages
/
{pageID}
UpdatePageAPI mirrors the erdo_update_page MCP tool.
curl --request PUT \
--url https://api.erdo.ai/v1/pages/{pageID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"css": "<string>",
"dataset_slugs": [
"<string>"
],
"html": "<string>",
"js": "<string>",
"kv_slugs": [
"<string>"
],
"meta_description": "<string>",
"meta_icon_asset_id": "<string>",
"meta_image_asset_id": "<string>",
"meta_title": "<string>",
"page_id": "<string>",
"public": true,
"request_review": true,
"title": "<string>",
"writable_dataset_slugs": [
"<string>"
],
"writable_kv_slugs": [
"<string>"
]
}
'import requests
url = "https://api.erdo.ai/v1/pages/{pageID}"
payload = {
"css": "<string>",
"dataset_slugs": ["<string>"],
"html": "<string>",
"js": "<string>",
"kv_slugs": ["<string>"],
"meta_description": "<string>",
"meta_icon_asset_id": "<string>",
"meta_image_asset_id": "<string>",
"meta_title": "<string>",
"page_id": "<string>",
"public": True,
"request_review": True,
"title": "<string>",
"writable_dataset_slugs": ["<string>"],
"writable_kv_slugs": ["<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({
css: '<string>',
dataset_slugs: ['<string>'],
html: '<string>',
js: '<string>',
kv_slugs: ['<string>'],
meta_description: '<string>',
meta_icon_asset_id: '<string>',
meta_image_asset_id: '<string>',
meta_title: '<string>',
page_id: '<string>',
public: true,
request_review: true,
title: '<string>',
writable_dataset_slugs: ['<string>'],
writable_kv_slugs: ['<string>']
})
};
fetch('https://api.erdo.ai/v1/pages/{pageID}', 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/pages/{pageID}",
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([
'css' => '<string>',
'dataset_slugs' => [
'<string>'
],
'html' => '<string>',
'js' => '<string>',
'kv_slugs' => [
'<string>'
],
'meta_description' => '<string>',
'meta_icon_asset_id' => '<string>',
'meta_image_asset_id' => '<string>',
'meta_title' => '<string>',
'page_id' => '<string>',
'public' => true,
'request_review' => true,
'title' => '<string>',
'writable_dataset_slugs' => [
'<string>'
],
'writable_kv_slugs' => [
'<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/pages/{pageID}"
payload := strings.NewReader("{\n \"css\": \"<string>\",\n \"dataset_slugs\": [\n \"<string>\"\n ],\n \"html\": \"<string>\",\n \"js\": \"<string>\",\n \"kv_slugs\": [\n \"<string>\"\n ],\n \"meta_description\": \"<string>\",\n \"meta_icon_asset_id\": \"<string>\",\n \"meta_image_asset_id\": \"<string>\",\n \"meta_title\": \"<string>\",\n \"page_id\": \"<string>\",\n \"public\": true,\n \"request_review\": true,\n \"title\": \"<string>\",\n \"writable_dataset_slugs\": [\n \"<string>\"\n ],\n \"writable_kv_slugs\": [\n \"<string>\"\n ]\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/pages/{pageID}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"css\": \"<string>\",\n \"dataset_slugs\": [\n \"<string>\"\n ],\n \"html\": \"<string>\",\n \"js\": \"<string>\",\n \"kv_slugs\": [\n \"<string>\"\n ],\n \"meta_description\": \"<string>\",\n \"meta_icon_asset_id\": \"<string>\",\n \"meta_image_asset_id\": \"<string>\",\n \"meta_title\": \"<string>\",\n \"page_id\": \"<string>\",\n \"public\": true,\n \"request_review\": true,\n \"title\": \"<string>\",\n \"writable_dataset_slugs\": [\n \"<string>\"\n ],\n \"writable_kv_slugs\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.erdo.ai/v1/pages/{pageID}")
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 \"css\": \"<string>\",\n \"dataset_slugs\": [\n \"<string>\"\n ],\n \"html\": \"<string>\",\n \"js\": \"<string>\",\n \"kv_slugs\": [\n \"<string>\"\n ],\n \"meta_description\": \"<string>\",\n \"meta_icon_asset_id\": \"<string>\",\n \"meta_image_asset_id\": \"<string>\",\n \"meta_title\": \"<string>\",\n \"page_id\": \"<string>\",\n \"public\": true,\n \"request_review\": true,\n \"title\": \"<string>\",\n \"writable_dataset_slugs\": [\n \"<string>\"\n ],\n \"writable_kv_slugs\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"cloned_pipelines": [
{
"id": "<string>",
"purpose": "<string>",
"slug": "<string>",
"source_id": "<string>"
}
],
"id": "<string>",
"meta_description": "<string>",
"meta_icon_asset_id": "<string>",
"meta_image_asset_id": "<string>",
"meta_title": "<string>",
"notes": [
"<string>"
],
"public": true,
"public_url": "<string>",
"review": {
"issues": [
{
"category": "<string>",
"description": "<string>",
"id": "<string>",
"judge_slug": "<string>",
"severity": "<string>",
"suggestion": "<string>"
}
],
"judges": [
"<string>"
],
"lighthouse": {
"accessibility": 123,
"best_practices": 123,
"fetched_at": "2023-11-07T05:31:56Z",
"performance": 123,
"seo": 123
},
"reason": "<string>",
"reviewed": true,
"summary": "<string>"
},
"rewrites": {},
"source_page_id": "<string>",
"thread_id": "<string>",
"title": "<string>",
"url": "<string>",
"validation": {
"errors": [
{
"column": 123,
"context": "<string>",
"field": "<string>",
"line": 123,
"message": "<string>",
"severity": "<string>"
}
],
"valid": true
},
"warning": "<string>"
}{
"code": "not_found",
"details": {},
"message": "<string>"
}Authorizations
An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).
Path Parameters
Body
application/json
Erdo default; a uuid sets. See DeployPageInput.
(including "") is written. See DeployPageInput.MetaTitle.
update_html_artifact/edit_html_artifact tools (PR #2055), for writers that aren't an agent: this CLI/REST/MCP surface. Reviews already run automatically on a page's first build and on a full rewrite; this is the door for everything in between.
clears that grant. Mirrors dataset_slugs semantics on the write side.
Response
Success response
cloned_pipelines
ClonedPipelineSummary reports one lead-capture event pipeline duplicated onto
· object[]
Show child attributes
Show child attributes
ids (favicon / share image), nil when unset.
(nil when unset), so a caller can confirm what it just deployed/updated without a separate read.
request_review. Structured rather than prose so the tool result can carry it without a second formatting layer inventing its own vocabulary.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
clone_from_page_id deploy: the page the copy was made from, the lead-capture pipelines duplicated onto it, every id substitution applied to the copied content, and anything the caller still has to act on.
share link and is only present while the page is public. Use these values verbatim — hosts differ across prod/staging/local.
validation
ArtifactValidationResult lives in this package so both the private API layer and
· object
action callers can reference it without importing the validator implementation.
Show child attributes
Show child attributes
successful content deploy/update). The page exists and is usable; the calling agent should surface this to the user and retry the failing op.