Skip to main content
POST
/
v1
/
agents
Create a new agent
curl --request POST \
  --url https://api.devic.ai/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Sales Assistant Agent",
  "description": "<string>",
  "imgUrl": "<string>",
  "assistantSpecialization": {
    "identifier": "<string>",
    "name": "<string>",
    "description": "<string>",
    "presets": "<string>",
    "availableToolsGroupsUids": [
      "<string>"
    ],
    "enabledTools": [
      "<string>"
    ],
    "model": "<string>",
    "provider": "<string>",
    "imgUrl": "<string>",
    "codeSnippetIds": [
      "<string>"
    ],
    "availableSkillIds": [
      "<string>"
    ],
    "subagentsIds": [
      "<string>"
    ],
    "maxChatMessages": 123,
    "maxToolResponseInputTokens": 123
  },
  "provider": "<string>",
  "llm": "<string>",
  "maxExecutionInputTokens": 123,
  "maxExecutionToolCalls": 123,
  "maxExecutionFrequency": 123,
  "executionFrequencyIntervalMs": 123,
  "concurrentExecutionLimit": 123,
  "agentNotificationConfig": {
    "enabled": true,
    "enableEmailNotification": true,
    "notifiedEmails": [
      "<string>"
    ],
    "approvalEmails": [
      "<string>"
    ]
  },
  "evaluationConfig": {
    "enabled": true,
    "customCriteria": [
      {}
    ],
    "disableDefaultEvaluation": true
  }
}
'
{
  "_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "imgUrl": "<string>",
  "disabled": true,
  "archived": true,
  "provider": "<string>",
  "llm": "<string>",
  "assistantSpecialization": {
    "identifier": "<string>",
    "name": "<string>",
    "description": "<string>",
    "presets": "<string>",
    "availableToolsGroupsUids": [
      "<string>"
    ],
    "enabledTools": [
      "<string>"
    ],
    "model": "<string>",
    "provider": "<string>",
    "imgUrl": "<string>",
    "codeSnippetIds": [
      "<string>"
    ],
    "availableSkillIds": [
      "<string>"
    ],
    "subagentsIds": [
      "<string>"
    ],
    "maxChatMessages": 123,
    "maxToolResponseInputTokens": 123
  },
  "creationTimestampMs": 123,
  "lastEditTimestampMs": 123,
  "maxExecutionInputTokens": 123,
  "maxExecutionToolCalls": 123,
  "agentNotificationConfig": {},
  "evaluationConfig": {}
}

Authorizations

Authorization
string
header
required

Use JWT token for authentication

Body

application/json
name
string
required

Agent name

Example:

"Sales Assistant Agent"

description
string

Agent description

imgUrl
string

Image URL for the agent

assistantSpecialization
object

Configuration for the assistant specialization

provider
string

LLM provider override

llm
string

LLM model name override

maxExecutionInputTokens
integer

Maximum input tokens per execution

maxExecutionToolCalls
integer

Maximum tool calls per execution

maxExecutionFrequency
integer

Maximum executions in a timeframe

executionFrequencyIntervalMs
integer

Timeframe in milliseconds for execution frequency limit

concurrentExecutionLimit
integer

Maximum concurrent executions

agentNotificationConfig
object
evaluationConfig
object

Response

Agent created successfully

_id
string

Agent ID

name
string

Agent name

description
string

Agent description

imgUrl
string

Image URL

disabled
boolean

Whether the agent is disabled

archived
boolean

Whether the agent is archived

provider
string

LLM provider

llm
string

LLM model name

assistantSpecialization
object

Configuration for the assistant specialization

creationTimestampMs
integer

Creation timestamp in milliseconds

lastEditTimestampMs
integer

Last edit timestamp in milliseconds

maxExecutionInputTokens
integer

Maximum input tokens per execution

maxExecutionToolCalls
integer

Maximum tool calls per execution

agentNotificationConfig
object
evaluationConfig
object