Create an external or hosted agent

post/v1/agents

Request

  • Base URL: https://api.skysay.ai
  • URL: https://api.skysay.ai/v1/agents
  • Auth: none declared

Request body

audio_stream_urlstring
begin_messagestring
languagestring
languagesstring[]

The languages this agent may answer in. An engine without a language axis (see voice_frontend and the agent-catalog conversation_engines block) REFUSES this field with 400 rather than accepting and dropping it.

mode'external_audio' | 'external_text' | 'hosted' required
namestring
organization_idstring required
project_idstring required
recording_enabledboolean
system_promptstring
webhook_urlstring

Response

Agent. agent_endpoint.webhook_secret carries the plaintext secret that signs every event and tool call sent to this agent's webhook (X-Agent-Telco-Signature), revealed once in this response only; every later read returns [REDACTED]. Save it immediately.

Changes

No recorded changes to this operation across all 2 revisions of this API.