Create an Agent

post

https://api.d-id.com/agents

Creates a new Agent.

Body Params

preview_name

string

Agent name

preview_description

string

Description of the agent

presenter

required

Defines the Agent’s avatar, including its visual appearance and voice.

llm

Configuration for the Large Language Model used by the Agent to generate responses. D-ID and Google providers are only supported with Expressive Avatar presenters.

knowledge

object

Knowledge Base used by the Agent to retrieve answers (RAG). Use the ID returned by the Create Knowledge endpoint.

starter_message

array of strings

List of suggested questions shown to the user at the start of the chat.

starter_message

greetings

array of strings

Greeting messages used when the chat starts. One greeting is selected at random.

greetings

user_data

string

length between 1 and 1000

embed

boolean

Enables the Agent for use with the SDK or website embedding via D-ID Studio.

triggers

object

Event-based trigger configuration for the Agent.

Headers

x-api-key-external

string

Use your own ElevenLabs API key for TTS (IVC voices only), consuming your ElevenLabs quota. Example: {"elevenlabs": "ABCDEFGH123456"}

Responses

Language

Credentials

Basic

base64

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

401AuthorizationError