POST
/
api
/
v3
/
agents
/
create
/
Create Agent Endpoint
curl --request POST \
  --url https://api.nugen.in/api/v3/agents/create/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_name": "<string>",
  "agent_description": "<string>",
  "model": "<string>",
  "temperature": 0.7,
  "instructions": "<string>",
  "demonstrations": [
    {}
  ]
}'
{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "baseModel": "<string>",
    "baseModelName": "<string>",
    "createdDate": "<string>",
    "status": "<string>",
    "creator": "<string>",
    "endpoint": "<string>",
    "usageCount": 123,
    "lastUsed": "<string>",
    "performanceMetrics": {
      "averageUncertainty": 123,
      "humanInterventions": 123,
      "averageResponseTime": 123,
      "userSatisfactionScore": 123
    },
    "systemPrompt": "<string>",
    "uncertaintyThreshold": 123
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request model for creating a new agent - matches frontend exactly

agent_name
string
required

Name of the agent

agent_description
string
required

Description of the agent

model
string
required

Base model identifier

temperature
number
default:0.7

Temperature for model responses

instructions
string | null

System prompt for the agent

demonstrations
Demonstrations · object[] | null

Training demonstrations

Response

Successful Response

Response model for agent creation endpoint.

data
object
required

Agent information model