A valid request URL is required to generate request examplesevent: token
data: {"reply":"Adding a Spanish greeting…"}
event: done
data: {"reply":"Done — Spanish is now enabled with a greeting.","appliedMutations":[{"method":"PATCH","path":"/agents/agt_4f9c2b7e10a24d51","operationId":"updateAgent","summary":"Set Spanish greeting + enable es"}]}
{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Configure an agent with AI
Sends a natural-language request to an AI assistant that edits this agent for you. It streams progress and returns the assistant’s reply along with the list of changes it applied to the agent.
A valid request URL is required to generate request examplesevent: token
data: {"reply":"Adding a Spanish greeting…"}
event: done
data: {"reply":"Done — Spanish is now enabled with a greeting.","appliedMutations":[{"method":"PATCH","path":"/agents/agt_4f9c2b7e10a24d51","operationId":"updateAgent","summary":"Set Spanish greeting + enable es"}]}
{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
- Token URL
- /api/v1/api-keys
Path Parameters
The agent's unique ID (the UUID returned by createAgent / listAgents).
Body
Plain-language instruction describing the change to make to this agent.
Response
SSE stream; terminal frame carries AssistResult.
The thread this turn belongs to (persistent memory).
Show child attributes
Show child attributes
Destructive tool calls the copilot wants to run, held until the user confirms (re-send as confirmed).
Show child attributes
Show child attributes
OAuth connect affordances the client renders as a button (never the raw consent URL in the reply prose).
Show child attributes
Show child attributes