[{"data":1,"prerenderedAt":996},["ShallowReactive",2],{"navigation_docs":3,"-applications-ai-agents-rest-agent-control":388,"-applications-ai-agents-rest-agent-control-surround":991},[4,82,147,173,202,259,298,355],{"title":5,"icon":6,"redirect":7,"path":8,"stem":9,"children":10,"page":73},"Start","i-lucide-compass","\u002Fintro\u002Fquickstart","\u002Fintro","1.intro",[11,14,18,22,74,78],{"title":12,"path":7,"stem":13},"Quickstart","1.intro\u002F0.quickstart",{"title":15,"path":16,"stem":17},"Pipeline Applications","\u002Fintro\u002Fpipeline-app-walkthrough","1.intro\u002F1.pipeline-app-walkthrough",{"title":19,"path":20,"stem":21},"How Redgold works","\u002Fintro\u002Foverview","1.intro\u002F2.overview",{"title":23,"icon":24,"visibility":25,"redirect":26,"path":27,"stem":28,"children":29,"page":73},"Comparison","i-lucide-scale","private","\u002Fintro\u002Fcomparison\u002Fpositioning","\u002Fintro\u002Fcomparison","1.intro\u002F3.comparison",[30,33,37,41,45,49,53,57,61,65,69],{"title":31,"path":26,"stem":32},"Positioning","1.intro\u002F3.comparison\u002F1.positioning",{"title":34,"path":35,"stem":36},"vs Lovable","\u002Fintro\u002Fcomparison\u002Fvs-lovable","1.intro\u002F3.comparison\u002F10.vs-lovable",{"title":38,"path":39,"stem":40},"vs Cloudflare OS","\u002Fintro\u002Fcomparison\u002Fvs-cloudflare-os","1.intro\u002F3.comparison\u002F11.vs-cloudflare-os",{"title":42,"path":43,"stem":44},"vs a backend-as-a-service","\u002Fintro\u002Fcomparison\u002Fvs-baas","1.intro\u002F3.comparison\u002F2.vs-baas",{"title":46,"path":47,"stem":48},"vs serverless compute","\u002Fintro\u002Fcomparison\u002Fvs-serverless-compute","1.intro\u002F3.comparison\u002F3.vs-serverless-compute",{"title":50,"path":51,"stem":52},"vs a do-it-yourself data stack","\u002Fintro\u002Fcomparison\u002Fvs-diy-data-stack","1.intro\u002F3.comparison\u002F4.vs-diy-data-stack",{"title":54,"path":55,"stem":56},"vs Rama","\u002Fintro\u002Fcomparison\u002Fvs-rama","1.intro\u002F3.comparison\u002F5.vs-rama",{"title":58,"path":59,"stem":60},"vs Apache Spark","\u002Fintro\u002Fcomparison\u002Fvs-spark","1.intro\u002F3.comparison\u002F6.vs-spark",{"title":62,"path":63,"stem":64},"vs Apache DataFusion","\u002Fintro\u002Fcomparison\u002Fvs-datafusion","1.intro\u002F3.comparison\u002F7.vs-datafusion",{"title":66,"path":67,"stem":68},"vs Heroku","\u002Fintro\u002Fcomparison\u002Fvs-heroku","1.intro\u002F3.comparison\u002F8.vs-heroku",{"title":70,"path":71,"stem":72},"vs AI model providers","\u002Fintro\u002Fcomparison\u002Fvs-ai-providers","1.intro\u002F3.comparison\u002F9.vs-ai-providers",false,{"title":75,"path":76,"stem":77},"Common tasks","\u002Fintro\u002Fstarting-points","1.intro\u002F4.starting-points",{"title":79,"path":80,"stem":81},"FAQ","\u002Fintro\u002Ffaq","1.intro\u002F5.faq",{"title":83,"icon":84,"redirect":85,"path":86,"stem":87,"children":88,"page":73},"Examples","i-lucide-chef-hat","\u002Fcookbook\u002Foverview","\u002Fcookbook","10.cookbook",[89,91,95,99,103,107,111,115,119,123,127,131,135,139,143],{"title":83,"path":85,"stem":90},"10.cookbook\u002F1.overview",{"title":92,"path":93,"stem":94},"One-shot task in CI","\u002Fcookbook\u002Fone-shot-ci","10.cookbook\u002F10.one-shot-ci",{"title":96,"path":97,"stem":98},"Rate-limit retries","\u002Fcookbook\u002Fretry-rate-limits","10.cookbook\u002F11.retry-rate-limits",{"title":100,"path":101,"stem":102},"Connect GitHub review automation","\u002Fcookbook\u002Fconnect-github-app","10.cookbook\u002F12.connect-github-app",{"title":104,"path":105,"stem":106},"Delegate a task to another agent","\u002Fcookbook\u002Fdelegate-agent-task","10.cookbook\u002F13.delegate-agent-task",{"title":108,"path":109,"stem":110},"Validate a pipeline application change","\u002Fcookbook\u002Fvalidate-pipeline-app","10.cookbook\u002F14.validate-pipeline-app",{"title":112,"path":113,"stem":114},"Verify a managed application deployment","\u002Fcookbook\u002Fverify-managed-deploy","10.cookbook\u002F15.verify-managed-deploy",{"title":116,"path":117,"stem":118},"First API call","\u002Fcookbook\u002Ffirst-api-call","10.cookbook\u002F2.first-api-call",{"title":120,"path":121,"stem":122},"Python client","\u002Fcookbook\u002Fmodel-api-python","10.cookbook\u002F3.model-api-python",{"title":124,"path":125,"stem":126},"Anthropic Messages","\u002Fcookbook\u002Fanthropic-messages","10.cookbook\u002F4.anthropic-messages",{"title":128,"path":129,"stem":130},"Check credits","\u002Fcookbook\u002Fcheck-credits","10.cookbook\u002F5.check-credits",{"title":132,"path":133,"stem":134},"Query data via MCP","\u002Fcookbook\u002Fmcp-query-data","10.cookbook\u002F6.mcp-query-data",{"title":136,"path":137,"stem":138},"Drive an agent via MCP","\u002Fcookbook\u002Fmcp-drive-agent","10.cookbook\u002F7.mcp-drive-agent",{"title":140,"path":141,"stem":142},"Install the client","\u002Fcookbook\u002Finstall-client","10.cookbook\u002F8.install-client",{"title":144,"path":145,"stem":146},"Use another API host","\u002Fcookbook\u002Fpoint-client-at-host","10.cookbook\u002F9.point-client-at-host",{"title":148,"icon":149,"redirect":150,"path":151,"stem":152,"children":153,"page":73},"Agent operations","i-lucide-network","\u002Ffleet\u002Foverview","\u002Ffleet","11.fleet",[154,157,161,165,169],{"title":155,"path":150,"stem":156},"Running agent work","11.fleet\u002F0.overview",{"title":158,"path":159,"stem":160},"Workstreams and issues","\u002Ffleet\u002Fworkstreams-and-issues","11.fleet\u002F1.workstreams-and-issues",{"title":162,"path":163,"stem":164},"Agent lifecycle","\u002Ffleet\u002Fagent-lifecycle","11.fleet\u002F2.agent-lifecycle",{"title":166,"path":167,"stem":168},"Supervision and recovery","\u002Ffleet\u002Fsupervision","11.fleet\u002F3.supervision",{"title":170,"path":171,"stem":172},"An application workstream from request to delivery","\u002Ffleet\u002Fapplication-workstream","11.fleet\u002F4.application-workstream",{"title":174,"icon":175,"redirect":176,"path":177,"stem":178,"children":179,"page":73},"Architecture","i-lucide-layers","\u002Finfrastructure\u002Foverview","\u002Finfrastructure","3.infrastructure",[180,182,186,190,194,198],{"title":174,"path":176,"stem":181},"3.infrastructure\u002F0.overview",{"title":183,"path":184,"stem":185},"A request through the platform","\u002Finfrastructure\u002Frequest-path","3.infrastructure\u002F11.request-path",{"title":187,"path":188,"stem":189},"Agent work and durable state","\u002Finfrastructure\u002Fagent-work","3.infrastructure\u002F12.agent-work",{"title":191,"path":192,"stem":193},"Data and pipelines","\u002Finfrastructure\u002Fdata","3.infrastructure\u002F3.data",{"title":195,"path":196,"stem":197},"AI and agents","\u002Finfrastructure\u002Fai","3.infrastructure\u002F4.ai",{"title":199,"path":200,"stem":201},"Managed deployment","\u002Finfrastructure\u002Fdeployment","3.infrastructure\u002F7.deployment",{"title":203,"icon":204,"redirect":205,"path":206,"stem":207,"children":208,"page":73},"API","i-lucide-book-marked","\u002Freference\u002Fauthentication","\u002Freference","4.reference",[209,212,216,220,224,228,232,236,240,244,248],{"title":210,"path":205,"stem":211},"Authentication","4.reference\u002F1.authentication",{"title":213,"path":214,"stem":215},"Security disclosure policy","\u002Freference\u002Fsecurity-disclosure","4.reference\u002F11.security-disclosure",{"title":217,"path":218,"stem":219},"Model API","\u002Freference\u002Fllm-api","4.reference\u002F2.llm-api",{"title":221,"path":222,"stem":223},"MCP server","\u002Freference\u002Fmcp","4.reference\u002F2.mcp",{"title":225,"path":226,"stem":227},"Data platform preview","\u002Freference\u002Fdata-platform-preview","4.reference\u002F3.data-platform-preview",{"title":229,"path":230,"stem":231},"Terminal client","\u002Freference\u002Fcli","4.reference\u002F6.cli",{"title":233,"path":234,"stem":235},"Pipeline manifest preview","\u002Freference\u002Fpipeline-preview","4.reference\u002F7.pipeline-preview",{"title":237,"path":238,"stem":239},"Limits and retries","\u002Freference\u002Flimits","4.reference\u002F8.limits",{"title":241,"path":242,"stem":243},"API contract details","\u002Freference\u002Fapi-contracts","4.reference\u002F9.api-contracts",{"title":245,"path":246,"stem":247},"Errors","\u002Freference\u002Ferrors","4.reference\u002F9.errors",{"title":249,"icon":250,"visibility":251,"path":252,"stem":253,"children":254,"page":73},"Public API","i-lucide-route","public","\u002Freference\u002Froutes","4.reference\u002Froutes",[255],{"title":256,"path":257,"stem":258},"V1 routes","\u002Freference\u002Froutes\u002Fv1","4.reference\u002Froutes\u002Fv1",{"title":260,"icon":261,"visibility":25,"redirect":262,"path":263,"stem":264,"children":265,"page":73},"Develop","i-lucide-code","\u002Fdevelop\u002Fpipeline-apps\u002Foverview","\u002Fdevelop","5.develop",[266,270,286,290,294],{"title":267,"path":268,"stem":269},"Author a batch transform","\u002Fdevelop\u002Fauthor-a-batch-transform","5.develop\u002F10.author-a-batch-transform",{"title":271,"visibility":251,"redirect":262,"path":272,"stem":273,"children":274,"page":73},"Pipeline Apps","\u002Fdevelop\u002Fpipeline-apps","5.develop\u002F11.pipeline-apps",[275,278,282],{"title":276,"path":262,"stem":277},"Pipeline apps","5.develop\u002F11.pipeline-apps\u002F1.overview",{"title":279,"path":280,"stem":281},"Collaborative board walkthrough","\u002Fdevelop\u002Fpipeline-apps\u002Fcollaborative-board","5.develop\u002F11.pipeline-apps\u002F2.collaborative-board",{"title":283,"path":284,"stem":285},"Release and security lifecycle","\u002Fdevelop\u002Fpipeline-apps\u002Frelease-lifecycle","5.develop\u002F11.pipeline-apps\u002F3.release-lifecycle",{"title":287,"path":288,"stem":289},"Build a vertical","\u002Fdevelop\u002Fbuild-a-vertical","5.develop\u002F5.build-a-vertical",{"title":291,"path":292,"stem":293},"Managed application artifacts","\u002Fdevelop\u002Fscaffold-a-narrow-app","5.develop\u002F7.scaffold-a-narrow-app",{"title":295,"path":296,"stem":297},"Import your data","\u002Fdevelop\u002Fimport-your-data","5.develop\u002F8.import-your-data",{"title":299,"icon":300,"redirect":301,"path":302,"stem":303,"children":304,"page":73},"Guides","i-lucide-layout-grid","\u002Fapplications\u002Fai-agents\u002Foverview","\u002Fapplications","7.applications",[305,309,329,341],{"title":306,"path":307,"stem":308},"Application maturity catalog","\u002Fapplications\u002Fcatalog","7.applications\u002F0.catalog",{"title":310,"visibility":251,"path":311,"stem":312,"children":313,"page":73},"AI Agents","\u002Fapplications\u002Fai-agents","7.applications\u002F1.ai-agents",[314,317,321,325],{"title":315,"path":301,"stem":316},"Coding agents","7.applications\u002F1.ai-agents\u002F01.overview",{"title":318,"path":319,"stem":320},"GitHub App automation","\u002Fapplications\u002Fai-agents\u002Fgithub-app-automation","7.applications\u002F1.ai-agents\u002F04.github-app-automation",{"title":322,"path":323,"stem":324},"agent-cli assistance","\u002Fapplications\u002Fai-agents\u002Fagent-cli-assistance","7.applications\u002F1.ai-agents\u002F05.agent-cli-assistance",{"title":326,"path":327,"stem":328},"Agent REST control","\u002Fapplications\u002Fai-agents\u002Frest-agent-control","7.applications\u002F1.ai-agents\u002F06.rest-agent-control",{"title":330,"visibility":251,"path":331,"stem":332,"children":333,"page":73},"Tickets","\u002Fapplications\u002Ftickets","7.applications\u002F2.tickets",[334,337],{"title":330,"path":335,"stem":336},"\u002Fapplications\u002Ftickets\u002Foverview","7.applications\u002F2.tickets\u002F01.overview",{"title":338,"path":339,"stem":340},"API walkthrough","\u002Fapplications\u002Ftickets\u002Fapi-walkthrough","7.applications\u002F2.tickets\u002F02.api-walkthrough",{"title":342,"icon":343,"visibility":251,"path":344,"stem":345,"children":346,"page":73},"Case studies","i-lucide-book-open-check","\u002Fapplications\u002Fcase-studies","7.applications\u002F6.case-studies",[347,351],{"title":348,"path":349,"stem":350},"Case study: owner-scoped tickets","\u002Fapplications\u002Fcase-studies\u002Ftickets","7.applications\u002F6.case-studies\u002F01.tickets",{"title":352,"path":353,"stem":354},"Case study: repository review and correction","\u002Fapplications\u002Fcase-studies\u002Frepository-review","7.applications\u002F6.case-studies\u002F02.repository-review",{"title":356,"icon":357,"redirect":358,"path":359,"stem":360,"children":361,"page":73},"Resources","i-lucide-library","\u002Fresources\u002Fglossary","\u002Fresources","9.resources",[362,365,369,373,377,380,384],{"title":363,"path":358,"stem":364},"Glossary","9.resources\u002F1.glossary",{"title":366,"path":367,"stem":368},"Terms of Service","\u002Fresources\u002Fterms","9.resources\u002F2.terms",{"title":370,"path":371,"stem":372},"Privacy Policy","\u002Fresources\u002Fprivacy","9.resources\u002F3.privacy",{"title":374,"path":375,"stem":376},"Acceptable Use Policy","\u002Fresources\u002Facceptable-use","9.resources\u002F4.acceptable-use",{"title":79,"path":378,"stem":379},"\u002Fresources\u002Ffaq","9.resources\u002F5.faq",{"title":381,"path":382,"stem":383},"Documentation feedback","\u002Fresources\u002Fdocs-feedback","9.resources\u002F6.docs-feedback",{"title":385,"path":386,"stem":387},"Refund and Cancellation Policy","\u002Fresources\u002Frefund-cancellation","9.resources\u002F7.refund-cancellation",{"id":389,"title":390,"access":391,"audience":392,"body":393,"description":982,"extension":983,"last_verified":984,"links":985,"maturity":986,"meta":987,"navigation":988,"path":327,"seo":989,"stem":328,"__hash__":990},"docs\u002F7.applications\u002F1.ai-agents\u002F06.rest-agent-control.md","Control an assigned agent through REST","onboarding","developer",{"type":394,"value":395,"toc":975},"minimark",[396,414,419,443,502,505,509,675,678,770,779,783,859,870,874,927,930,934,961,971],[397,398,399,400,404,405,409,410,413],"p",{},"The ",[401,402,403],"code",{},"\u002Fv1\u002Fagents\u002F*"," routes provide customer-controlled lifecycle operations for an agent slot already assigned to the authenticated account. They are a managed onboarding preview and are absent from the generated public allowlist in the ",[406,407,408],"a",{"href":257},"V1 route reference",", so they are outside the self-service public API contract. Use the ",[406,411,412],{"href":222},"MCP agent tools"," when an approval-gated tool call fits the client better.",[415,416,418],"h2",{"id":417},"prerequisites","Prerequisites",[420,421,422,430,433],"ul",{},[423,424,425,426,429],"li",{},"An ",[401,427,428],{},"sk-rg-"," API key.",[423,431,432],{},"An agent slot assigned to your account. The REST spawn route does not allocate capacity.",[423,434,435,438,439,442],{},[401,436,437],{},"curl"," and ",[401,440,441],{},"jq",".",[444,445,450],"pre",{"className":446,"code":447,"language":448,"meta":449,"style":449},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export REDGOLD_API_KEY=sk-rg-...\nexport REDGOLD_API=https:\u002F\u002Fapi.redgold.ai\nexport REDGOLD_AGENT_SLOT=\u003Cassigned-slot>\n","bash","",[401,451,452,472,485],{"__ignoreMap":449},[453,454,457,461,465,469],"span",{"class":455,"line":456},"line",1,[453,458,460],{"class":459},"spNyl","export",[453,462,464],{"class":463},"sTEyZ"," REDGOLD_API_KEY",[453,466,468],{"class":467},"sMK4o","=",[453,470,471],{"class":463},"sk-rg-...\n",[453,473,475,477,480,482],{"class":455,"line":474},2,[453,476,460],{"class":459},[453,478,479],{"class":463}," REDGOLD_API",[453,481,468],{"class":467},[453,483,484],{"class":463},"https:\u002F\u002Fapi.redgold.ai\n",[453,486,488,490,493,496,499],{"class":455,"line":487},3,[453,489,460],{"class":459},[453,491,492],{"class":463}," REDGOLD_AGENT_SLOT",[453,494,495],{"class":467},"=\u003C",[453,497,498],{"class":463},"assigned-slot",[453,500,501],{"class":467},">\n",[397,503,504],{},"The service verifies that the slot belongs to the authenticated caller on every lifecycle request.",[415,506,508],{"id":507},"start-the-assigned-slot","Start the assigned slot",[444,510,512],{"className":446,"code":511,"language":448,"meta":449,"style":449},"spawn_response=$(curl --fail-with-body --silent --show-error \\\n  \"$REDGOLD_API\u002Fv1\u002Fagents\" \\\n  -H \"Authorization: Bearer $REDGOLD_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  --data \"$(jq -nc --arg slot \"$REDGOLD_AGENT_SLOT\" \\\n    --arg prompt \"Inspect the repository tests and report the smallest failing scope.\" \\\n    '{slot: $slot, prompt: $prompt}')\")\n\nprintf '%s\\n' \"$spawn_response\" | jq\n",[401,513,514,538,554,572,586,609,624,639,646],{"__ignoreMap":449},[453,515,516,519,522,525,529,532,535],{"class":455,"line":456},[453,517,518],{"class":463},"spawn_response",[453,520,521],{"class":467},"=$(",[453,523,437],{"class":524},"sBMFI",[453,526,528],{"class":527},"sfazB"," --fail-with-body",[453,530,531],{"class":527}," --silent",[453,533,534],{"class":527}," --show-error",[453,536,537],{"class":463}," \\\n",[453,539,540,543,546,549,552],{"class":455,"line":474},[453,541,542],{"class":467},"  \"",[453,544,545],{"class":463},"$REDGOLD_API",[453,547,548],{"class":527},"\u002Fv1\u002Fagents",[453,550,551],{"class":467},"\"",[453,553,537],{"class":463},[453,555,556,559,562,565,568,570],{"class":455,"line":487},[453,557,558],{"class":527},"  -H",[453,560,561],{"class":467}," \"",[453,563,564],{"class":527},"Authorization: Bearer ",[453,566,567],{"class":463},"$REDGOLD_API_KEY",[453,569,551],{"class":467},[453,571,537],{"class":463},[453,573,575,577,579,582,584],{"class":455,"line":574},4,[453,576,558],{"class":527},[453,578,561],{"class":467},[453,580,581],{"class":527},"Content-Type: application\u002Fjson",[453,583,551],{"class":467},[453,585,537],{"class":463},[453,587,589,592,595,597,600,602,605,607],{"class":455,"line":588},5,[453,590,591],{"class":527},"  --data",[453,593,594],{"class":467}," \"$(",[453,596,441],{"class":524},[453,598,599],{"class":527}," -nc --arg slot ",[453,601,551],{"class":467},[453,603,604],{"class":463},"$REDGOLD_AGENT_SLOT",[453,606,551],{"class":467},[453,608,537],{"class":463},[453,610,612,615,617,620,622],{"class":455,"line":611},6,[453,613,614],{"class":527},"    --arg prompt ",[453,616,551],{"class":467},[453,618,619],{"class":527},"Inspect the repository tests and report the smallest failing scope.",[453,621,551],{"class":467},[453,623,537],{"class":463},[453,625,627,630,633,636],{"class":455,"line":626},7,[453,628,629],{"class":467},"    '",[453,631,632],{"class":527},"{slot: $slot, prompt: $prompt}",[453,634,635],{"class":467},"')\"",[453,637,638],{"class":467},")\n",[453,640,642],{"class":455,"line":641},8,[453,643,645],{"emptyLinePlaceholder":644},true,"\n",[453,647,649,653,656,659,662,664,667,669,672],{"class":455,"line":648},9,[453,650,652],{"class":651},"s2Zo4","printf",[453,654,655],{"class":467}," '",[453,657,658],{"class":527},"%s\\n",[453,660,661],{"class":467},"'",[453,663,561],{"class":467},[453,665,666],{"class":463},"$spawn_response",[453,668,551],{"class":467},[453,670,671],{"class":467}," |",[453,673,674],{"class":524}," jq\n",[397,676,677],{},"The response acknowledges the lifecycle command before startup finishes:",[444,679,683],{"className":680,"code":681,"language":682,"meta":449,"style":449},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"ok\": true,\n  \"commandId\": \"acmd-...\",\n  \"allocatedSlot\": \"\u003Cassigned-slot>\",\n  \"status\": \"provisioning\"\n}\n","json",[401,684,685,690,705,726,746,765],{"__ignoreMap":449},[453,686,687],{"class":455,"line":456},[453,688,689],{"class":467},"{\n",[453,691,692,694,697,699,702],{"class":455,"line":474},[453,693,542],{"class":467},[453,695,696],{"class":459},"ok",[453,698,551],{"class":467},[453,700,701],{"class":467},":",[453,703,704],{"class":467}," true,\n",[453,706,707,709,712,714,716,718,721,723],{"class":455,"line":487},[453,708,542],{"class":467},[453,710,711],{"class":459},"commandId",[453,713,551],{"class":467},[453,715,701],{"class":467},[453,717,561],{"class":467},[453,719,720],{"class":527},"acmd-...",[453,722,551],{"class":467},[453,724,725],{"class":467},",\n",[453,727,728,730,733,735,737,739,742,744],{"class":455,"line":574},[453,729,542],{"class":467},[453,731,732],{"class":459},"allocatedSlot",[453,734,551],{"class":467},[453,736,701],{"class":467},[453,738,561],{"class":467},[453,740,741],{"class":527},"\u003Cassigned-slot>",[453,743,551],{"class":467},[453,745,725],{"class":467},[453,747,748,750,753,755,757,759,762],{"class":455,"line":588},[453,749,542],{"class":467},[453,751,752],{"class":459},"status",[453,754,551],{"class":467},[453,756,701],{"class":467},[453,758,561],{"class":467},[453,760,761],{"class":527},"provisioning",[453,763,764],{"class":467},"\"\n",[453,766,767],{"class":455,"line":611},[453,768,769],{"class":467},"}\n",[397,771,772,774,775,778],{},[401,773,732],{}," identifies the assigned slot used by the command; REST does not allocate a new one. Use ",[401,776,777],{},"list_agent_sessions"," through MCP or the signed-in agent view to observe readiness.",[415,780,782],{"id":781},"send-another-prompt","Send another prompt",[444,784,786],{"className":446,"code":785,"language":448,"meta":449,"style":449},"curl --fail-with-body --silent --show-error \\\n  \"$REDGOLD_API\u002Fv1\u002Fagents\u002F$REDGOLD_AGENT_SLOT\u002Fmessages\" \\\n  -H \"Authorization: Bearer $REDGOLD_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  --data '{\"text\":\"Now run the focused test and report its exact result.\"}' | jq\n",[401,787,788,800,818,832,844],{"__ignoreMap":449},[453,789,790,792,794,796,798],{"class":455,"line":456},[453,791,437],{"class":524},[453,793,528],{"class":527},[453,795,531],{"class":527},[453,797,534],{"class":527},[453,799,537],{"class":463},[453,801,802,804,806,809,811,814,816],{"class":455,"line":474},[453,803,542],{"class":467},[453,805,545],{"class":463},[453,807,808],{"class":527},"\u002Fv1\u002Fagents\u002F",[453,810,604],{"class":463},[453,812,813],{"class":527},"\u002Fmessages",[453,815,551],{"class":467},[453,817,537],{"class":463},[453,819,820,822,824,826,828,830],{"class":455,"line":487},[453,821,558],{"class":527},[453,823,561],{"class":467},[453,825,564],{"class":527},[453,827,567],{"class":463},[453,829,551],{"class":467},[453,831,537],{"class":463},[453,833,834,836,838,840,842],{"class":455,"line":574},[453,835,558],{"class":527},[453,837,561],{"class":467},[453,839,581],{"class":527},[453,841,551],{"class":467},[453,843,537],{"class":463},[453,845,846,848,850,853,855,857],{"class":455,"line":588},[453,847,591],{"class":527},[453,849,655],{"class":467},[453,851,852],{"class":527},"{\"text\":\"Now run the focused test and report its exact result.\"}",[453,854,661],{"class":467},[453,856,671],{"class":467},[453,858,674],{"class":524},[397,860,861,862,865,866,869],{},"The message call returns a ",[401,863,864],{},"messageId"," and the target ",[401,867,868],{},"slot",". Sending another prompt preserves the agent's current session context unless the environment has ended that session.",[415,871,873],{"id":872},"stop-the-slot","Stop the slot",[444,875,877],{"className":446,"code":876,"language":448,"meta":449,"style":449},"curl --fail-with-body --silent --show-error \\\n  -X DELETE \"$REDGOLD_API\u002Fv1\u002Fagents\u002F$REDGOLD_AGENT_SLOT\" \\\n  -H \"Authorization: Bearer $REDGOLD_API_KEY\" | jq\n",[401,878,879,891,911],{"__ignoreMap":449},[453,880,881,883,885,887,889],{"class":455,"line":456},[453,882,437],{"class":524},[453,884,528],{"class":527},[453,886,531],{"class":527},[453,888,534],{"class":527},[453,890,537],{"class":463},[453,892,893,896,899,901,903,905,907,909],{"class":455,"line":474},[453,894,895],{"class":527},"  -X",[453,897,898],{"class":527}," DELETE",[453,900,561],{"class":467},[453,902,545],{"class":463},[453,904,808],{"class":527},[453,906,604],{"class":463},[453,908,551],{"class":467},[453,910,537],{"class":463},[453,912,913,915,917,919,921,923,925],{"class":455,"line":487},[453,914,558],{"class":527},[453,916,561],{"class":467},[453,918,564],{"class":527},[453,920,567],{"class":463},[453,922,551],{"class":467},[453,924,671],{"class":467},[453,926,674],{"class":524},[397,928,929],{},"Destroy is asynchronous like spawn. Its response includes a command id and status for the requested stop.",[415,931,933],{"id":932},"boundaries-and-errors","Boundaries and errors",[420,935,936,942,945,955,958],{},[423,937,938,941],{},[401,939,940],{},"401"," means the bearer key is missing, malformed, or revoked.",[423,943,944],{},"A forbidden ownership response means the slot is outside the caller's ownership scope.",[423,946,947,948,950,951,954],{},"A validation response naming ",[401,949,868],{}," or ",[401,952,953],{},"text"," means that required value is absent.",[423,956,957],{},"A successful spawn acknowledgement means the command was accepted; session readiness follows asynchronously.",[423,959,960],{},"Repository access comes from the assigned environment. A lifecycle request does not expand repository or tenant permissions.",[397,962,963,964,967,968,442],{},"Managed operators and trusted agents can use the curated CLI alternative in ",[406,965,966],{"href":323},"Assist agents with agent-cli",". Repository-triggered pull-request work is covered by ",[406,969,970],{"href":319},"GitHub App repository automation",[972,973,974],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}",{"title":449,"searchDepth":474,"depth":474,"links":976},[977,978,979,980,981],{"id":417,"depth":474,"text":418},{"id":507,"depth":474,"text":508},{"id":781,"depth":474,"text":782},{"id":872,"depth":474,"text":873},{"id":932,"depth":474,"text":933},"Start, prompt, and stop an agent slot assigned to your account through the authenticated V1 API.","md","2026-08-12",null,"preview",{"toc":644,"visibility":251},{"title":326},{"title":390,"description":982},"LCgXPMJp5JGUnVUGi9uAh_NN-Fh_mi2fzjHUAlcxo6g",[992,994],{"title":322,"path":323,"stem":324,"description":993,"children":-1},"Curated agent-cli workflows for trusted agents and operators coordinating work in a managed Redgold environment.",{"title":330,"path":335,"stem":336,"description":995,"children":-1},"The issue-board app, walked end to end — one checked-in Rust serde schema encoded with CBOR, a set of pipeline routes, owner-scoped storage, and a GitOps deploy — as the worked example of the platform's narrow-app shape.",1789873222413]