Agents

Create agent

Create a new AI agent for the authenticated organization

post/agents

Request

Base URL: https://api.weav.com/v1
URL: https://api.weav.com/v1/agents
Auth: HTTP bearer

Request body

namestring required

descriptionstring nullable

avatar_urlstring url nullable

max_messages_per_sessioninteger nullable

tonestring nullable

response_lengthstring nullable

is_activeboolean nullable

Example request

{
  "name": "Agent",
  "description": "Helps customers with support queries",
  "avatar_url": "https://example.com/avatar.png",
  "max_messages_per_session": 50,
  "tone": "professional",
  "response_length": "standard",
  "is_active": true
}

Response

Agent created successfully

idstring uuid

namestring

slugstring

descriptionstring nullable

avatar_urlstring url nullable

max_messages_per_sessioninteger nullable

tonestring nullable

response_lengthstring nullable

is_activeboolean

is_copilotboolean

created_atstring date-time nullable

updated_atstring date-time nullable

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Agent",
  "slug": "agent",
  "description": "Helps customers with support queries",
  "avatar_url": "https://example.com/avatar.png",
  "max_messages_per_session": 50,
  "tone": "professional",
  "response_length": "standard",
  "is_active": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.