Create agent
Create an agent in the project. New agents start without a live version — create and publish a version to make the agent answer.
Authorizations
Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.
Path Parameters
^[0-9a-fA-F]{24}$Body
Create an agent. The owning project comes from the URL path.
Agent name
2 - 50Template agent to clone the new agent from. Omit to use the default template of the environment's default category.
^[0-9a-fA-F]{24}$Runtime build (e.g. '0.4.0') to stamp on the versions this create seeds. Omit to inherit the template's own runtime. Caller-supplied only — apollo never resolves a default from the runtime catalog.
1Response
Successful Response
Returns the created agent.
Agent id
^[0-9a-fA-F]{24}$Owning project id
^[0-9a-fA-F]{24}$Agent name
Creation timestamp
Last update timestamp
Tag of the currently deployed version; None until deployed
Runtime build the live version's bundle targets, e.g. '0.8.0'. None when nothing is deployed or the bundle pins no runtime
AUI schema version of the live version's bundle. None until deployed