pages family
Edit a workspace page's title or sections
One click hands your coding agent a prompt that registers the substrate, reads this contract, and makes the call. Launch opens the app; the others copy the prompt.
curl -X POST https://one.ie/api/ask/pages:edit \
-H "Authorization: Bearer $ONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"data": { "slug": <string>, "page": <string> }}'The key is never in a link. npx -y @oneie/cli login writes it to ~/.config/oneie/key on your machine.
Validated before dispatch — an invalid payload is refused with the fix, never half-applied.
slug string required page string required title string optional sections object[] optional puckData object optional Full replacement Puck data — any registry block. Top-level props are normalised and ids stamped exactly as `pages:create` does. Refused beside `sections`. root object optional PAGE SETTINGS — merged into the stored `data.root.props` (what Layout reads for the page's head, chat, dock and chrome). Only these keys; an empty string CLEARS a key so it falls back to its default. Refused beside `sections`. What comes back from the call.
ok boolean slug string title string url string status string updatedAt number error string quality object Template-strength verdict on the stored page. Fix what `missing` names before calling it done. Every call to pages:edit, counted where it is dispatched — over HTTP or in-process alike. Aggregate only — no actor, no payload, no workspace.
Counting…
Every place in the open source that names pages:edit, and the file that
answers it. Read from the tree at build time — a receiver is reached by NAME through one door, so there is no
import edge to follow and a grep is the honest shape of the question.
Structure, not volume — the count is in Traffic above.
Called from
Answered by
POST /api/ask/pages:edit, after the envelope
validates the payload.
pages family · 29 more
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"page": {
"type": "string"
},
"title": {
"type": "string"
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"component": {
"type": "string"
},
"props": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"component",
"props"
]
}
},
"puckData": {
"description": "Full replacement Puck data — any registry block. Top-level props are normalised and ids stamped exactly as `pages:create` does. Refused beside `sections`.",
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"root": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"content"
],
"additionalProperties": {}
},
"root": {
"description": "PAGE SETTINGS — merged into the stored `data.root.props` (what Layout reads for the page's head, chat, dock and chrome). Only these keys; an empty string CLEARS a key so it falls back to its default. Refused beside `sections`.",
"type": "object",
"properties": {
"description": {
"type": "string",
"maxLength": 500
},
"socialTitle": {
"type": "string",
"maxLength": 200
},
"ogImage": {
"type": "string",
"maxLength": 2000
},
"canonical": {
"type": "string",
"maxLength": 2000
},
"search": {
"type": "string",
"enum": [
"listed",
"hidden",
""
]
},
"chat": {
"type": "string",
"enum": [
"auto",
"show",
"panel",
"hide",
""
]
},
"dock": {
"type": "string",
"enum": [
"auto",
"show",
"hide",
""
]
},
"siteHeader": {
"type": "string",
"enum": [
"auto",
"hide",
""
]
},
"siteFooter": {
"type": "string",
"enum": [
"auto",
"hide",
""
]
}
},
"additionalProperties": false
}
},
"required": [
"slug",
"page"
]
} {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"status": {
"type": "string"
},
"updatedAt": {
"type": "number"
},
"error": {
"type": "string"
},
"quality": {
"type": "object",
"properties": {
"score": {
"type": "number"
},
"max": {
"type": "number"
},
"missing": {
"type": "array",
"items": {
"type": "string"
},
"description": "Checks the page fails — each has a line in `fix`"
},
"fix": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
},
"description": "check → how to fix it"
},
"why": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "check → the offending block ids and values (at most 5 per check)"
},
"factTokens": {
"description": "`{{ns.key}}` / `[Fact]` tokens still in the copy. Each fills from the workspace's business facts at render; one with no fact DROPS its sentence. Write the real value where you know it.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"score",
"max",
"missing",
"fix",
"why"
],
"description": "Template-strength verdict on the stored page. Fix what `missing` names before calling it done."
}
},
"required": [
"ok"
]
}