Create a New Agent

Create a new AI agent with custom configuration and capabilities

POST /api/agents

Create a new agent

cURL

curl --request POST \
  --url http://localhost:3000/api/agents \
  --header 'Content-Type: application/json' \
  --data '
{
  "characterPath": "<string>",
  "characterJson": {}
}
'

201

{
  "success": true,
  "data": {
    "character": {
      "name": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bio": "<string>",
      "settings": {},
      "system": "<string>",
      "style": {},
      "lore": [
        "<string>"
      ],
      "messageExamples": [
        "<string>"
      ],
      "topics": [
        "<string>"
      ],
      "plugins": [
        "<string>"
      ]
    }
  }
}

Body

application/json

characterPath · string

Path to a character file

characterJson · object

Character configuration in JSON format

Response

201

application/json

Agent created successfully

success · boolean

Example:

true

data · object

Show child attributes