Create Agent Definition

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

The communication channel for the agent. Values: "voice", "text".

Display name for the agent.

The external voice provider. Values: "vapi", "retell", "eleven_labs", "others". Required for voice agents.

API key for the external voice provider. Required for outbound agents or when observabilityEnabled is true.

Assistant ID from the external provider. Required for outbound agents or when observabilityEnabled is true.

Description for the initial agent version.

Primary language as an ISO 639-1 two-letter code (e.g., "en", "es").

UUID of a knowledge base to link to the agent.

Phone country code without the + prefix (e.g., "1", "91").

Full phone number with country code prefix (e.g., "+14155551234"). Number portion must be 10-12 digits.

Whether the agent handles inbound calls. Defaults to false (outbound-only).

Commit message for the initial version. A default is generated if omitted.

Enables ingestion of call logs and transcripts from the provider. Requires apiKey and assistantId.

Missing required fields or invalid values.

Invalid or missing API credentials.

Unexpected server error.