Logo
Search
Docs

Create agent

POST https://app.sulus.ai/api/v1/agents

Create an agent

Authentication

Send a bearer token created on your dashboard's Developer page:

Authorization: Bearer <YOUR_API_KEY>

Request body

name string Required

Agent display name.

Validation: required|string|max:255
Stored in ai_projects.name
description string Optional Nullable

What the agent is for.

Validation: sometimes|nullable|string|max:5000
Stored in ai_projects.description
instructions string Optional Nullable

Persistent system prompt.

Validation: sometimes|nullable|string|max:10000
Stored in ai_projects.instructions

Errors

StatusMeaningBody
422 Validation failed {"message":"…","errors":{"field":["…"]}}
401 Missing or invalid bearer token
403 Feature ai_chat not enabled for the account 
curl --request POST \
  --url https://app.sulus.ai/api/v1/agents \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Support Agent",
  "description": "Answers customer support questions.",
  "instructions": "Be concise and friendly."
}'
import requests

url = "https://app.sulus.ai/api/v1/agents"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}
payload = {
  "name": "Support Agent",
  "description": "Answers customer support questions.",
  "instructions": "Be concise and friendly."
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	url := "https://app.sulus.ai/api/v1/agents"
	payload := strings.NewReader(`{
  "name": "Support Agent",
  "description": "Answers customer support questions.",
  "instructions": "Be concise and friendly."
}`)
	req, _ := http.NewRequest("POST", url, payload)
	req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
	req.Header.Add("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
Response 201 
{
    "object": "agent",
    "data": {
        "id": "a1b2c3d4-0000-4000-8000-000000000001",
        "object": "agent",
        "name": "Support Agent",
        "description": "Answers customer support questions.",
        "instructions": "Be concise and friendly.",
        "memory": null,
        "created_at": "2026-07-30T14:12:03.000000Z",
        "last_activity_at": "2026-07-30T14:12:03.000000Z"
    }
}