Create an agent

Creates an agent in the API key workspace. Requires agents:write.

This creates configuration only. The agent cannot start a native run until isActive is true and it satisfies runtime prerequisites.

POST/agents

Authorization

AuthorizationBearer <token>

Bodyrequired

application/json

object

Additional properties are not allowed.

namestringrequired

minLength: 1
maxLength: 100

slugstring

Optional stable slug for create-only workflows. If omitted, Salambo derives one from name.

pattern: "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$"

descriptionstring | null

maxLength: 500

iconstring | null

maxLength: 10

commandContentstring

isActiveboolean

Public active/inactive switch.

Response

application/json

Created agent.

object

idstringrequired

format: "uuid"

public_idstringrequired

pattern: "^agt_[A-Za-z0-9]+$"

objectstringrequired

const: "agent"

namestringrequired

slugstringrequired

descriptionstring | null

iconstring | null

command_contentstring

is_activebooleanrequired

Public active/inactive switch. Active agents can appear in the model list.

created_atintegerrequired

updated_atintegerrequired

curl --request POST \
  --url 'https://YOUR_SALAMBO_BASE_URL/api/v1/agents' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '@request.json'

Replace placeholders before running. JSON templates without a sample body read your payload from request.json.

Response

{
  "id": "<string>",
  "public_id": "<string>",
  "object": "agent",
  "name": "<string>",
  "slug": "<string>",
  "description": "<string | null>",
  "icon": "<string | null>",
  "command_content": "<string>",
  "is_active": true,
  "created_at": 123,
  "updated_at": 123
}