curl --request POST \ --url https://developer.creao.ai/v1/agents/{agent_id}/edits \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "instructions": "Add a valuation sensitivity table for the selected ticker and include a short note on downside risk."}'
const url = 'https://developer.creao.ai/v1/agents/{agent_id}/edits';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
instructions: 'Add a valuation sensitivity table for the selected ticker and include a short note on downside risk.'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));
import requests
url = "https://developer.creao.ai/v1/agents/{agent_id}/edits"
payload = { "instructions": "Add a valuation sensitivity table for the selected ticker and include a short note on downside risk." }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
Start an async natural-language edit for a personal agent.
POST
/
v1
/
agents
/
{agent_id}
/
edits
Edit an agent from instructions
curl --request POST \ --url https://developer.creao.ai/v1/agents/{agent_id}/edits \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "instructions": "Add a valuation sensitivity table for the selected ticker and include a short note on downside risk."}'
const url = 'https://developer.creao.ai/v1/agents/{agent_id}/edits';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
instructions: 'Add a valuation sensitivity table for the selected ticker and include a short note on downside risk.'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));
import requests
url = "https://developer.creao.ai/v1/agents/{agent_id}/edits"
payload = { "instructions": "Add a valuation sensitivity table for the selected ticker and include a short note on downside risk." }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
Account API key from Developer Console. Keys start with cr_sk_.
Path Parameters
agent_id
string<uuid>
required
Personal CREAO agent to edit.
Body
application/json
instructions
string
required
Natural-language description of the changes to make to the agent.
Required string length: 1 - 65536
model
string
Model id to run with (for example, anthropic/claude-haiku-4-5). Omit to use the agent's default model and thinking level (see default_model_id on the agent), or anthropic/claude-sonnet-5-5 when the agent has none. Supported ids: https://agent.docs.creao.ai/developer-api/supported-models. Unknown ids return 400 MODEL_NOT_SUPPORTED; models not available on your plan return 403 MODEL_NOT_ALLOWED.
Maximum string length: 100
release_note
string | null
Optional caller-provided release note for the persisted agent update.
Maximum string length: 2000
Response
Agent edit accepted.
run_id
string<uuid>
required
Backing CREAO CLI run ID for polling/debugging.
agent_id
string<uuid>
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed,
cancelled
result
object
Terminal edit result when the edit succeeds.
usage
object
Settlement credits plus an optional per-model breakdown for the run.
Omitted when the run incurred no cost and collected no model usage.
models is present only for Super Agent–allowlisted accounts.
Token fields appear only for token-metered capabilities. Per-image
and per-second capabilities use generated_images or duration_seconds
instead. kind tells the client which fields apply.
Show child attributes
error
object
Show child attributes
created_at
string<date-time>
started_at
string<date-time> | null
completed_at
string<date-time> | null
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CREAO Documentation","colors":{"primary":"#000000","light":"#666666","dark":"#333333"},"logo":{"light":"https://mintcdn.com/creaoagent/qsO6D45JE0FrSrZO/logo/light.svg?fit=max\u0026auto=format\u0026n=qsO6D45JE0FrSrZO\u0026q=85\u0026s=c85112c81c4c08190781587305b2c952","dark":"https://mintcdn.com/creaoagent/qsO6D45JE0FrSrZO/logo/dark.svg?fit=max\u0026auto=format\u0026n=qsO6D45JE0FrSrZO\u0026q=85\u0026s=569d79e8794145f8bb87aa5a5dde7cc7"},"favicon":"https://mintcdn.com/creaoagent/qsO6D45JE0FrSrZO/favicon.svg?fit=max\u0026auto=format\u0026n=qsO6D45JE0FrSrZO\u0026q=85\u0026s=1a8f63e36d68f08b47fab42c4fe0e7e2","api":{"playground":{"display":"simple"},"examples":{"defaults":"required","languages":["bash","node","python"],"prefill":true}},"navbar":{"links":[],"primary":{"type":"button","label":"Try CREAO","href":"https://agent.creao.ai"}},"footer":{"socials":{"x":"https://x.com/CreaoAI","linkedin":"https://www.linkedin.com/company/creaoai","discord":"https://discord.gg/VPNExXcP9W"}},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"CREAO","icon":"rocket","href":"https://agent.creao.ai"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/VPNExXcP9W"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"creaoagent","hasAudioNarration":false,"actualSubdomain":"creaoagent","customDomains":["docs.creao.ai"],"gitSource":{"type":"github","owner":"creaoai","repo":"creao-monorepo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0202b64546409c89e3b568","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"CREAO CLI","count":67},{"language":"default","tag":"Using CREAO","count":26},{"language":"default","tag":"Concepts","count":14},{"language":"default","tag":"Features","count":11},{"language":"default","tag":"Get Started","count":7},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"Rooms","count":7},{"language":"default","tag":"Skills","count":6},{"language":"default","tag":"Agent Brain","count":5},{"language":"default","tag":"Workspaces","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"developer-api/agents/create-agent-edit","slug":"/developer-api/agents/create-agent-edit","pageMetadata":{"title":"Edit an agent from instructions","description":"Start an async natural-language edit for a personal agent.","deprecated":null,"version":null,"sidebarTitle":"Create agent edit","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/agents/{agent_id}/edits","href":"/developer-api/agents/create-agent-edit","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Start an async natural-language edit for a personal agent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Edit an agent from instructions","description":"Start an async natural-language edit for a personal agent.","deprecated":null,"version":null,"sidebarTitle":"Create agent edit","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/agents/{agent_id}/edits","href":"/developer-api/agents/create-agent-edit","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Agents"],"summary":"Edit an agent from instructions","description":"Start an async natural-language edit for a personal agent.","operationId":"createAgentEdit","x-mint":{"href":"/developer-api/agents/create-agent-edit","metadata":{"title":"Edit an agent from instructions","description":"Start an async natural-language edit for a personal agent."}},"parameters":["fdec843f-8c4c-4f98-8dc9-059cc6f15478"],"requestBody":"f24476e7-f11d-4aaa-9cbc-13546c077d01","responses":{"202":"4d60b01d-c831-4db1-af53-b2b9ca3eb62b","400":"8350611d-d247-4463-885d-b88f368de64a","401":"cd577f01-a062-4ed4-85b3-ae611557d3dd","402":"da38ad09-3527-41f8-bc5e-0d47bb0b3c5e","403":"6b19f997-354e-4ad6-a21e-402b951471c6","404":"5dc8ed1f-a16f-4cda-b79d-2719cd78b996","429":"8fbdd883-94b0-495a-9eb9-088e30136601","503":"b995bc65-a619-43c6-829d-df06d6038b80"},"method":"post","type":"path","servers":["c3247528-b36a-406e-ab4b-afdddf1d8bed"],"security":["c9a67c4b-4032-4d7c-8eea-c21e3fff086d","294a0a7a-720d-42aa-8c89-7bc8384ae5d0"],"path":"/v1/agents/{agent_id}/edits","baseUrlOptions":["https://developer.creao.ai"],"title":"Edit an agent from instructions","codeSamples":[],"requestExampleLanguages":["bash","node","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.instructions":"Add a valuation sensitivity table for the selected ticker and include a short note on downside risk.","body.model":"anthropic/claude-haiku-4-5","body.release_note.oneOf.0":"Add valuation sensitivity section."}]},"dependencies":{"parameters":{"fdec843f-8c4c-4f98-8dc9-059cc6f15478":{"name":"agent_id","in":"path","required":true,"description":"Personal CREAO agent to edit.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Personal CREAO agent to edit.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["instructions"],"properties":{"instructions":{"type":"string","minLength":1,"maxLength":65536,"description":"Natural-language description of the changes to make to the agent.","isRequired":true,"uniqueKey":"instructions","typeLabel":"string"},"model":{"type":"string","maxLength":100,"description":"Model id to run with (for example, `anthropic/claude-haiku-4-5`). Omit to use the agent's default model and thinking level (see `default_model_id` on the agent), or `anthropic/claude-sonnet-5-5` when the agent has none. Supported ids: https://agent.docs.creao.ai/developer-api/supported-models. Unknown ids return 400 `MODEL_NOT_SUPPORTED`; models not available on your plan return 403 `MODEL_NOT_ALLOWED`.","uniqueKey":"model","typeLabel":"string"},"release_note":{"oneOf":[{"type":"string","description":"Optional caller-provided release note for the persisted agent update.","maxLength":2000,"uniqueKey":"release_note.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional caller-provided release note for the persisted agent update.","uniqueKey":"release_note.oneOf.1","typeLabel":"null"}],"uniqueKey":"release_note","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"addValuationSensitivity":{"title":"addValuationSensitivity","summary":"Add stock valuation analysis","value":{"instructions":"Add a valuation sensitivity table for the selected ticker and include a short note on downside risk.","release_note":"Add valuation sensitivity section.","model":"anthropic/claude-haiku-4-5"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"4d60b01d-c831-4db1-af53-b2b9ca3eb62b":{"description":"Agent edit accepted.","content":{"application/json":{"schema":{"type":"object","required":["run_id","agent_id","status"],"properties":{"run_id":{"type":"string","format":"uuid","description":"Backing CREAO CLI run ID for polling/debugging.","isRequired":true,"uniqueKey":"run_id","typeLabel":"string\u003cuuid>"},"agent_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"agent_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"result":{"type":"object","additionalProperties":true,"description":"Terminal edit result when the edit succeeds.","uniqueKey":"result","typeLabel":"object"},"usage":{"type":"object","description":"Settlement credits plus an optional per-model breakdown for the run.\nOmitted when the run incurred no cost and collected no model usage.\n`models` is present only for Super Agent–allowlisted accounts.\nToken fields appear only for token-metered capabilities. Per-image\nand per-second capabilities use `generated_images` or `duration_seconds`\ninstead. `kind` tells the client which fields apply.\n","properties":{"credits":{"type":"number","description":"Credits attributed to this CREAO CLI run. Settlement figure when cost is greater than zero.","uniqueKey":"usage.credits","typeLabel":"number"},"models":{"type":"array","description":"One row per `(model, kind)` aggregated for the run. Top-level `model`\nremains the requested chat model. Non-model bridge spend such as\nPDF parse is excluded.\n","items":{"type":"object","required":["model","kind"],"properties":{"model":{"type":"string","maxLength":100,"description":"Model id that produced this usage row.","isRequired":true,"uniqueKey":"usage.models.items.[INDEX].model","typeLabel":"string"},"kind":{"type":"string","enum":["chat","image_analysis","image_generation","video_generation","speech_to_text","text_to_speech","music_generation"],"isRequired":true,"uniqueKey":"usage.models.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"input_tokens":{"type":"integer","minimum":0,"uniqueKey":"usage.models.items.[INDEX].input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","minimum":0,"uniqueKey":"usage.models.items.[INDEX].output_tokens","typeLabel":"integer"},"cache_read_tokens":{"type":"integer","minimum":0,"uniqueKey":"usage.models.items.[INDEX].cache_read_tokens","typeLabel":"integer"},"cache_write_tokens":{"type":"integer","minimum":0,"uniqueKey":"usage.models.items.[INDEX].cache_write_tokens","typeLabel":"integer"},"generated_images":{"type":"integer","minimum":0,"description":"Present for per-image billing (for example GPT Image or Seedream).","uniqueKey":"usage.models.items.[INDEX].generated_images","typeLabel":"integer"},"duration_seconds":{"type":"number","minimum":0,"description":"Present for per-second video billing (for example Veo).","uniqueKey":"usage.models.items.[INDEX].duration_seconds","typeLabel":"number"}},"uniqueKey":"usage.models.items.[INDEX]","typeLabel":"object"},"uniqueKey":"usage.models","typeLabel":"object[]"}},"uniqueKey":"usage","typeLabel":"object"},"error":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Stable machine-readable failure code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"started_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","uniqueKey":"completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"completed_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"queued":{"title":"queued","value":{"run_id":"11111111-1111-4111-8111-111111111111","agent_id":"00000000-0000-4000-8000-000000000000","status":"queued","created_at":"2026-07-03T10:00:00.000Z","started_at":null,"completed_at":null}}},"exampleType":"examples"}},"exampleType":"examples"},"8350611d-d247-4463-885d-b88f368de64a":{"description":"Invalid request shape, invalid UUID, unsupported model, or unsupported status filter.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalidInput":{"title":"invalidInput","value":{"error":"INVALID_INPUT"}},"modelNotSupported":{"title":"modelNotSupported","value":{"error":"MODEL_NOT_SUPPORTED"}}},"exampleType":"examples"}},"exampleType":"examples"},"cd577f01-a062-4ed4-85b3-ae611557d3dd":{"description":"Missing, malformed, revoked, or unknown Account API key.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missingKey":{"title":"missingKey","value":{"error":"AUTHENTICATION_REQUIRED"}}},"exampleType":"examples"}},"exampleType":"examples"},"da38ad09-3527-41f8-bc5e-0d47bb0b3c5e":{"description":"Account does not have enough credits to start the run.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"insufficientCredits":{"title":"insufficientCredits","value":{"error":"INSUFFICIENT_CREDITS","available":0,"required":1000}}},"exampleType":"examples"}},"exampleType":"examples"},"6b19f997-354e-4ad6-a21e-402b951471c6":{"description":"Account is blocked from starting new runs, or the selected model is blocked by plan or entitlement access.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"accountBlocked":{"title":"accountBlocked","value":{"error":"ACCOUNT_BLOCKED"}},"modelNotAllowed":{"title":"modelNotAllowed","value":{"error":"MODEL_NOT_ALLOWED"}}},"exampleType":"examples"}},"exampleType":"examples"},"5dc8ed1f-a16f-4cda-b79d-2719cd78b996":{"description":"Agent not found for this account or not editable through CREAO CLI.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"agentNotFound":{"title":"agentNotFound","value":{"error":"AGENT_NOT_FOUND"}}},"exampleType":"examples"}},"exampleType":"examples"},"8fbdd883-94b0-495a-9eb9-088e30136601":{"description":"Account-level or IP-level rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"rateLimited":{"title":"rateLimited","value":{"error":"RATE_LIMITED"}}},"exampleType":"examples"}},"exampleType":"examples"},"b995bc65-a619-43c6-829d-df06d6038b80":{"description":"Agent execution service was unavailable before the run was accepted.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Debug message. Do not rely on this field in production clients.","uniqueKey":"message","typeLabel":"string"},"available":{"type":"number","description":"Available credits, when returned for credit errors.","uniqueKey":"available","typeLabel":"number"},"required":{"type":"number","description":"Required credits, when returned for credit errors.","uniqueKey":"required","typeLabel":"number"},"retryAfterSeconds":{"type":"integer","description":"Retry delay, when returned for hourly cap errors.","uniqueKey":"retryAfterSeconds","typeLabel":"integer"},"reason":{"type":"string","description":"A readable explanation on `400` and `409` room and agent bundle errors. Do not branch on it.","uniqueKey":"reason","typeLabel":"string"},"latest_version":{"type":"string","description":"The agent's latest saved version, on `AGENT_VERSION_NOT_INCREASED`.","uniqueKey":"latest_version","typeLabel":"string"},"candidates":{"type":"array","description":"Members a `ROOM_MENTION_AMBIGUOUS` name matches. Resend with one of their ids in `mentions` to pick it.","items":{"type":"object","properties":{"member_id":{"type":"string","format":"uuid","uniqueKey":"candidates.items.[INDEX].member_id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["user","agent"],"uniqueKey":"candidates.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"candidates.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"candidates.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"candidates.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"candidates.items.[INDEX]","typeLabel":"object"},"uniqueKey":"candidates","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"unavailable":{"title":"unavailable","value":{"error":"SERVICE_UNAVAILABLE"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c9a67c4b-4032-4d7c-8eea-c21e3fff086d":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"cr_sk","description":"Account API key from Developer Console. Keys start with `cr_sk_`.","x-default":"cr_sk_your_key_here","scopes":[],"schemeName":"bearerAuth"}},"294a0a7a-720d-42aa-8c89-7bc8384ae5d0":{"apiKeyQuery":{"type":"apiKey","in":"query","name":"creao-api-key","description":"Account API key passed as a query parameter, for platforms that cannot\nset a custom Authorization header. The bearerAuth header takes\nprecedence when both are present.\n","x-default":"cr_sk_your_key_here","scopes":[],"schemeName":"apiKeyQuery"}}},"servers":{"c3247528-b36a-406e-ab4b-afdddf1d8bed":{"url":"https://developer.creao.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"cr_sk","description":"Account API key from Developer Console. Keys start with `cr_sk_`.","x-default":"cr_sk_your_key_here","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Account API key from Developer Console. Keys start with `cr_sk_`.","format":"bearer","default":"cr_sk_your_key_here","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"query","name":"creao-api-key","description":"Account API key passed as a query parameter, for platforms that cannot\nset a custom Authorization header. The bearerAuth header takes\nprecedence when both are present.\n","x-default":"cr_sk_your_key_here","scopes":[],"schemeName":"apiKeyQuery"},"schema":{"title":"creao-api-key","type":"string","description":"Account API key passed as a query parameter, for platforms that cannot\nset a custom Authorization header. The bearerAuth header takes\nprecedence when both are present.\n","isRequired":true,"default":"cr_sk_your_key_here","typeLabel":"string","deprecated":false},"schemeName":"apiKeyQuery","name":"creao-api-key"}],"title":"apiKeyQuery"}]},"originalFileLocation":"developer-api/developer-v1.openapi.yaml"},"subdomain":"creaoagent","siteName":"CREAO Documentation","title":"Edit an agent from instructions - CREAO Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T02:48:58.414Z","originalFileLocation":"developer-api/agents/create-agent-edit.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Start an async natural-language edit for a personal agent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CREAO Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Edit an agent from instructions - CREAO Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Start an async natural-language edit for a personal agent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CREAO Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.creao.ai/developer-api/agents/create-agent-edit\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://creaoagent.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Edit+an+agent+from+instructions\u0026amp;description=Start+an+async+natural-language+edit+for+a+personal+agent.\u0026amp;theme=517419ff71a0ccc56d7c2a68\u0026amp;signature=7034075f9d97e04f29b437d5053145d5fc737a0a7f22eb84b97f5df5e5943043\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Edit an agent from instructions - CREAO Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Start an async natural-language edit for a personal agent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://creaoagent.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Edit+an+agent+from+instructions\u0026amp;description=Start+an+async+natural-language+edit+for+a+personal+agent.\u0026amp;theme=517419ff71a0ccc56d7c2a68\u0026amp;signature=7034075f9d97e04f29b437d5053145d5fc737a0a7f22eb84b97f5df5e5943043\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/creaoagent/tUWWd22AgUwL896o/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CREAO Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.creao.ai/developer-api/agents/create-agent-edit\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developer-api/agents/create-agent-edit.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.creao.ai/#organization\",\"name\":\"CREAO Documentation\",\"url\":\"https://docs.creao.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/creaoagent/qsO6D45JE0FrSrZO/logo/light.svg?fit=max\u0026auto=format\u0026n=qsO6D45JE0FrSrZO\u0026q=85\u0026s=c85112c81c4c08190781587305b2c952\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.creao.ai#website\",\"name\":\"CREAO Documentation\",\"url\":\"https://docs.creao.ai\",\"publisher\":{\"@id\":\"https://docs.creao.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.creao.ai/developer-api/agents/create-agent-edit#webpage\",\"url\":\"https://docs.creao.ai/developer-api/agents/create-agent-edit\",\"name\":\"Edit an agent from instructions\",\"description\":\"Start an async natural-language edit for a personal agent.\",\"dateModified\":\"2026-11-14T02:48:58.414Z\",\"isPartOf\":{\"@id\":\"https://docs.creao.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.creao.ai/developer-api/agents/create-agent-edit#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.creao.ai/developer-api/agents/create-agent-edit#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.creao.ai/developer-api/agents/create-agent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Edit an agent from instructions\",\"item\":\"https://docs.creao.ai/developer-api/agents/create-agent-edit\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.creao.ai/developer-api/agents/create-agent-edit#apireference\",\"headline\":\"Edit an agent from instructions\",\"name\":\"Edit an agent from instructions\",\"description\":\"Start an async natural-language edit for a personal agent.\",\"url\":\"https://docs.creao.ai/developer-api/agents/create-agent-edit\",\"mainEntityOfPage\":{\"@id\":\"https://docs.creao.ai/developer-api/agents/create-agent-edit#webpage\"},\"dateModified\":\"2026-11-14T02:48:58.414Z\",\"publisher\":{\"@id\":\"https://docs.creao.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.creao.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CREAO Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CREAO Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developer-api/agents/create-agent-edit.md","siteName":"CREAO Documentation","nav":{"global":{"anchors":[{"anchor":"CREAO","icon":"rocket","href":"https://agent.creao.ai"},{"anchor":"Community","icon":"discord","href":"https://discord.gg/VPNExXcP9W"}]},"tabs":[{"tab":"Using CREAO","pages":[{"title":"Using CREAO","href":""}]},{"tab":"CREAO CLI","groups":[{"group":"Get Started","pages":[{"title":"CREAO CLI Overview","href":"/developer-api/overview"},{"title":"CREAO CLI Quickstart","href":"/developer-api/quickstart"},{"title":"Authentication","href":"/developer-api/authentication"},{"title":"Supported Models","href":"/developer-api/supported-models"}]},{"group":"Agents","pages":[{"title":"Create an agent","deprecated":null,"version":null,"sidebarTitle":"Create agent","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/agents","href":"/developer-api/agents/create-agent"},{"title":"List agents","deprecated":null,"version":null,"sidebarTitle":"List agents","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents","href":"/developer-api/agents/list-agents"},{"title":"Get an agent","deprecated":null,"version":null,"sidebarTitle":"Get agent","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}","href":"/developer-api/agents/get-agent"},{"title":"Replace an agent","deprecated":null,"version":null,"sidebarTitle":"Replace agent","openapi":"/developer-api/developer-v1.openapi.yaml put /v1/agents/{agent_id}","href":"/developer-api/agents/replace-agent"},{"title":"Update agent settings","description":"Change a personal CREAO agent's write autonomy and default model.","deprecated":null,"version":null,"sidebarTitle":"Update agent","openapi":"/developer-api/developer-v1.openapi.yaml patch /v1/agents/{agent_id}","href":"/developer-api/agents/update-agent"},{"title":"Edit an agent from instructions","deprecated":null,"version":null,"sidebarTitle":"Create agent edit","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/agents/{agent_id}/edits","href":"/developer-api/agents/create-agent-edit"},{"title":"Get agent edit status","description":"Fetch status and result metadata for an agent edit.","deprecated":null,"version":null,"sidebarTitle":"Get agent edit","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}/edits/{run_id}","href":"/developer-api/agents/get-agent-edit"}]},{"group":"Agent Memory","pages":[{"title":"Get agent memory","deprecated":null,"version":null,"sidebarTitle":"Get agent memory","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}/memory","href":"/developer-api/agent-memory/get-agent-memory"},{"title":"Replace agent memory","deprecated":null,"version":null,"sidebarTitle":"Replace agent memory","openapi":"/developer-api/developer-v1.openapi.yaml put /v1/agents/{agent_id}/memory","href":"/developer-api/agent-memory/replace-agent-memory"},{"title":"Clear agent memory","deprecated":null,"version":null,"sidebarTitle":"Clear agent memory","openapi":"/developer-api/developer-v1.openapi.yaml delete /v1/agents/{agent_id}/memory","href":"/developer-api/agent-memory/clear-agent-memory"}]},{"group":"Agent Files","pages":[{"title":"List agent files","deprecated":null,"version":null,"sidebarTitle":"List agent files","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}/files","href":"/developer-api/agent-files/list-agent-files"},{"title":"Get agent file","deprecated":null,"version":null,"sidebarTitle":"Get agent file","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/agents/{agent_id}/files/{file_id}","href":"/developer-api/agent-files/get-agent-file"}]},{"group":"Product Profile","pages":[{"title":"Get product profile","deprecated":null,"version":null,"sidebarTitle":"Get product profile","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/product-profile","href":"/developer-api/product-profile/get-product-profile"},{"title":"Replace product profile","deprecated":null,"version":null,"sidebarTitle":"Put product profile","openapi":"/developer-api/developer-v1.openapi.yaml put /v1/product-profile","href":"/developer-api/product-profile/put-product-profile"}]},{"group":"Agent Runs","pages":[{"title":"Create an async run","deprecated":null,"version":null,"sidebarTitle":"Create async run","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/runs","href":"/developer-api/runs/create-async-run"},{"title":"Get run status","deprecated":null,"version":null,"sidebarTitle":"Get run status","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/runs/{run_id}","href":"/developer-api/runs/get-run-status"},{"title":"List runs","deprecated":null,"version":null,"sidebarTitle":"List runs","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/runs","href":"/developer-api/runs/list-runs"},{"title":"Create a realtime run","deprecated":null,"version":null,"sidebarTitle":"Create realtime run","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/realtime/runs","href":"/developer-api/runs/create-realtime-run"}]},{"group":"Super Agent","pages":[{"title":"Create a Super Agent async run","deprecated":null,"version":null,"sidebarTitle":"Create async run","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/super-agent/runs","href":"/developer-api/super-agent/create-async-run"},{"title":"Get Super Agent run status","deprecated":null,"version":null,"sidebarTitle":"Get run status","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/super-agent/runs/{run_id}","href":"/developer-api/super-agent/get-run-status"},{"title":"List Super Agent runs","deprecated":null,"version":null,"sidebarTitle":"List runs","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/super-agent/runs","href":"/developer-api/super-agent/list-runs"},{"title":"Create a Super Agent realtime run","deprecated":null,"version":null,"sidebarTitle":"Create realtime run","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/super-agent/realtime/runs","href":"/developer-api/super-agent/create-realtime-run"}]},{"group":"Account","pages":[{"title":"Get account usage","deprecated":null,"version":null,"sidebarTitle":"Get account usage","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/account/usage","href":"/developer-api/account/get-account-usage"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"sidebarTitle":"List workspaces","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/workspaces","href":"/developer-api/workspaces/list-workspaces"},{"title":"Create a workspace","deprecated":null,"version":null,"sidebarTitle":"Create workspace","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/workspaces","href":"/developer-api/workspaces/create-workspace"},{"title":"Get a workspace","deprecated":null,"version":null,"sidebarTitle":"Get workspace","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/workspaces/{workspace_id}","href":"/developer-api/workspaces/get-workspace"},{"title":"Add an agent to a workspace","deprecated":null,"version":null,"sidebarTitle":"Add workspace agent","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/workspaces/{workspace_id}/agents","href":"/developer-api/workspaces/add-workspace-agent"},{"title":"Remove an agent from a workspace","deprecated":null,"version":null,"sidebarTitle":"Remove workspace agent","openapi":"/developer-api/developer-v1.openapi.yaml delete /v1/workspaces/{workspace_id}/agents/{agent_id}","href":"/developer-api/workspaces/remove-workspace-agent"}]},{"group":"Workspace Files","pages":[{"title":"List workspace files","deprecated":null,"version":null,"sidebarTitle":"List workspace files","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/workspaces/{workspace_id}/files","href":"/developer-api/workspace-files/list-workspace-files"},{"title":"Upload a workspace file","deprecated":null,"version":null,"sidebarTitle":"Upload workspace file","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/workspaces/{workspace_id}/files","href":"/developer-api/workspace-files/upload-workspace-file"},{"title":"Get workspace file","deprecated":null,"version":null,"sidebarTitle":"Get workspace file","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/workspaces/{workspace_id}/files/{file_id}","href":"/developer-api/workspace-files/get-workspace-file"},{"title":"Delete workspace file","deprecated":null,"version":null,"sidebarTitle":"Delete workspace file","openapi":"/developer-api/developer-v1.openapi.yaml delete /v1/workspaces/{workspace_id}/files/{file_id}","href":"/developer-api/workspace-files/delete-workspace-file"}]},{"group":"Secrets","pages":[{"title":"List secret keys","deprecated":null,"version":null,"sidebarTitle":"List secrets","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/secrets","href":"/developer-api/secrets/list-secrets"},{"title":"Add a secret","deprecated":null,"version":null,"sidebarTitle":"Create secret","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/secrets","href":"/developer-api/secrets/create-secret"},{"title":"Update a secret","deprecated":null,"version":null,"sidebarTitle":"Update secret","openapi":"/developer-api/developer-v1.openapi.yaml patch /v1/secrets/{name}","href":"/developer-api/secrets/update-secret"},{"title":"Delete a secret","deprecated":null,"version":null,"sidebarTitle":"Delete secret","openapi":"/developer-api/developer-v1.openapi.yaml delete /v1/secrets/{name}","href":"/developer-api/secrets/delete-secret"}]},{"group":"Skills","pages":[{"title":"List skills","deprecated":null,"version":null,"sidebarTitle":"List skills","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/skills","href":"/developer-api/skills/list-skills"},{"title":"Install a skill","deprecated":null,"version":null,"sidebarTitle":"Install skill","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/skills","href":"/developer-api/skills/install-skill"},{"title":"Get a skill","deprecated":null,"version":null,"sidebarTitle":"Get skill","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/skills/{skill_id}","href":"/developer-api/skills/get-skill"},{"title":"Enable a skill","deprecated":null,"version":null,"sidebarTitle":"Enable skill","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/skills/{skill_id}/enable","href":"/developer-api/skills/enable-skill"},{"title":"Disable a skill","deprecated":null,"version":null,"sidebarTitle":"Disable skill","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/skills/{skill_id}/disable","href":"/developer-api/skills/disable-skill"},{"title":"Refresh a skill","deprecated":null,"version":null,"sidebarTitle":"Refresh skill","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/skills/{skill_id}/refresh","href":"/developer-api/skills/refresh-skill"}]},{"group":"Rooms","pages":[{"title":"List rooms","deprecated":null,"version":null,"sidebarTitle":"List rooms","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms","href":"/developer-api/rooms/list-rooms"},{"title":"Get a room","deprecated":null,"version":null,"sidebarTitle":"Get room","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}","href":"/developer-api/rooms/get-room"},{"title":"List room messages","deprecated":null,"version":null,"sidebarTitle":"List room messages","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}/messages","href":"/developer-api/rooms/list-room-messages"},{"title":"Post a room message","deprecated":null,"version":null,"sidebarTitle":"Post room message","openapi":"/developer-api/developer-v1.openapi.yaml post /v1/rooms/{room_id}/messages","href":"/developer-api/rooms/post-room-message"},{"title":"List room channels","deprecated":null,"version":null,"sidebarTitle":"List room channels","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}/channels","href":"/developer-api/rooms/list-room-channels"},{"title":"List room agents","deprecated":null,"version":null,"sidebarTitle":"List room agents","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}/agents","href":"/developer-api/rooms/list-room-agents"},{"title":"Stream room events","deprecated":null,"version":null,"sidebarTitle":"Stream room events","openapi":"/developer-api/developer-v1.openapi.yaml get /v1/rooms/{room_id}/events","href":"/developer-api/rooms/stream-room-events"}]},{"group":"Concepts","pages":[{"title":"Conversations","href":"/developer-api/conversations"},{"title":"Agent memory","href":"/developer-api/agent-memory"},{"title":"Agent files","href":"/developer-api/agent-files"},{"title":"Workspace files","href":"/developer-api/workspace-files"},{"title":"Workspaces","href":"/developer-api/workspaces"},{"title":"Secrets","href":"/developer-api/secrets"},{"title":"Skills","href":"/developer-api/skills"},{"title":"Rooms","href":"/developer-api/rooms"},{"title":"Models","href":"/developer-api/models"},{"title":"Streaming Events","href":"/developer-api/streaming-events"},{"title":"Webhooks","href":"/developer-api/webhooks"},{"title":"Errors","href":"/developer-api/errors"},{"title":"Rate Limits","href":"/developer-api/rate-limits"},{"title":"API Paths","href":"/developer-api/api-paths"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/community-and-updates/changelog"}]},{"tab":"Community","pages":[{"title":"Community","href":"/community-and-updates/community-hub"}]}]},"basePath":"","title":"Edit an agent from instructions - CREAO Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}