Agent Management

Create a new Agent

Upload a YAML configuration file to create and deploy a new agent. Optionally provide an agent icon (required for AgentStore deployments).

post/v1/agents/create

Request

Base URL
https://api.svahnar.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/svahnar/apis/svahnar-apis/docs/v1/agents/create/post.ts
A function with typed inputs. Its response is checked against the schema.

namestring required

The agent's name. Supports Unicode characters.

descriptionstring required

A brief description of the agent.

deploy_tostring required

Where to deploy the agent. Options: 'AgentStore' or 'Organization'.

yaml_filestring binary required

The YAML configuration for the agent.

agent_iconstring binary nullable

Successful Response

agent_idstring required

Unique identifier of the created agent.

messagestring required

Human-readable result message.

Feb 11, 2026c9a09aaa6236 Revision changes
- breaking
  removed the success response with the status
- info
  api tag Agent Management added
- info
  added the success response with the status
Apr 12, 20255eeb50d15e83 Revision changes
- info
  request property list-of-types was widened by adding types null to media type multipart/form-data