AI Agents API

AI Agents API An AI Agent is the brain behind your bot: its instructions, personality, language, knowledge and tools. You build an Agent once and then point traffic at it. This guide covers everything you can do with an Agent over the API — create it, configure it, give it knowledge and tools, review its drafts, and route conversations to it. Base URL — https://api.relaytiv.com/v1 Authentication — your API key (see Authentication ) Errors & paging — see Errors & Pagination All examples below show the ?apiKey= query form in cURL and the X-API-Key header in JavaScript and Python — either works on every endpoint. If you are new to Agents as a concept, read AI Agents first. How an Agent fits together Four things are managed separately, and it helps to know which is which before you start: Piece What it is Where you set it Configuration Instructions, rules, goal, personality, language, AI tier, booking and follow-up behaviour PUT /agents/{agentId} or the narrower PUT /agents/{agentId}/bot-config Knowledge FAQs and knowledge sources (pages and documents the platform has read for you) FAQs API and POST /agents/{agentId}/kb-sources Tools Custom functions and MCP servers the Agent may call mid-conversation POST /agents/{agentId}/custom-functions and POST /agents/{agentId}/mcp-servers Routing Which channels and conversations actually reach this Agent Entry Points — PUT /entry-points/channel-defaults and POST /agents/{agentId}/entry-points A new Agent answers nobody until you ro