v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
agent builder

Create an agent

Spaces method and path for this operation:

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/agent_builder/agents</span></div>

Refer to Spaces for more information.

Create a new agent. Use this endpoint to define the agent's behavior, appearance, and capabilities through comprehensive configuration options. To learn more about agents, refer to the agents documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageAgents.

post/api/agent_builder/agents

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

avatar_colorstring

Optional hex color code for the agent avatar.

avatar_symbolstring

Optional symbol/initials for the agent avatar.

descriptionstring required

Description of what the agent does.

idstring required

Unique identifier for the agent.

labelsstring[]

Optional labels for categorizing and organizing agents.

namestring required

Display name for the agent.

Response

Indicates a successful response