Text-to-Speech
Agent Conversations
Agent Actions
Agent Statistics
Agents
Create Agent
Agents
Create Agent
Create a new PlayAI Agent.
POST
/
api
/
v1
/
agents
curl --request POST \
--url https://api.play.ai/api/v1/agents \
--header 'Authorization: Bearer <token>' \
--header 'X-USER-ID: <api-key>' \
--header 'content-type: <content-type>' \
--data '{
"voice": "s3://voice-cloning-zero-shot/baf1ef41-36b6-428c-9bdf-50ba54682bd8/original/manifest.json",
"voiceSpeed": 1.2,
"ttsModel": "PlayHT2.0-turbo",
"displayName": "My Agent",
"description": "My agent is the best agent",
"greeting": "Hello! How can I help you today?",
"prompt": "You are an agent for a company that sells widgets. A customer calls in and asks about the different types of widgets you sell. You should respond by telling the customer about the different types of widgets you sell and how they differ from each other.\n",
"criticalKnowledge": "We have been in business for 20 years and have sold over 1 million widgets. Currently, we have 3 types of widgets: the standard widget, the deluxe widget, and the super widget. The standard widget is our most popular widget and is the most affordable. The deluxe widget is our mid-range widget and is popular with customers who want a little more than the standard widget. The super widget is our top of the line widget and is popular with customers who want the best of the best.",
"answerOnlyFromCriticalKnowledge": false,
"visibility": "public",
"language": "english",
"llm": null,
"actions": [
"f0gZrOKBKL7veJ6o1M"
]
}'
{
"id": "f0gZrOKBKL7veJ6o1M",
"voice": "s3://voice-cloning-zero-shot/baf1ef41-36b6-428c-9bdf-50ba54682bd8/original/manifest.json",
"voiceSpeed": 1.2,
"ttsModel": "PlayHT2.0-turbo",
"displayName": "My Agent",
"description": "My agent is the best agent",
"greeting": "Hello! How can I help you today?",
"prompt": "You are an agent for a company that sells widgets. A customer calls in and asks about the different types of widgets you sell. You should respond by telling the customer about the different types of widgets you sell and how they differ from each other.\n",
"criticalKnowledge": "We have been in business for 20 years and have sold over 1 million widgets. Currently, we have 3 types of widgets: the standard widget, the deluxe widget, and the super widget. The standard widget is our most popular widget and is the most affordable. The deluxe widget is our mid-range widget and is popular with customers who want a little more than the standard widget. The super widget is our top of the line widget and is popular with customers who want the best of the best.",
"answerOnlyFromCriticalKnowledge": false,
"visibility": "public",
"language": "english",
"llm": null,
"avatarPhotoUrl": "https://api.play.ai/api/v1/agents/as43.../avatar-photo",
"criticalKnowledgeFiles": [
{
"id": "e0e92064e26257fed1477465...",
"name": "whatever you want.pdf",
"url": "https://api.play.ai/api/v1/agents/as43.../critical-knowledge-files/e0e92...",
"size": 108439,
"type": "pdf"
}
],
"phoneNumbers": [
{
"phoneNumber": 13659874563,
"country": "US",
"locality": "Malibu"
}
],
"actions": [
"f0gZrOKBKL7veJ6o1M"
]
}
Required parameters include the agent’s name and the agent’s prompt.
After you create your agent, you can proceed to start a conversation using our Websocket API, or you can try it
out through our web interface at https://play.ai/agent/<your-agent-id>
.
To update the agents see the Update Agent endpoint.
Authorizations
Headers
Available options:
application/json
Available options:
application/json
Body
application/json
Response
201 - application/json
Agent resource response.
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://api.play.ai/api/v1/agents \
--header 'Authorization: Bearer <token>' \
--header 'X-USER-ID: <api-key>' \
--header 'content-type: <content-type>' \
--data '{
"voice": "s3://voice-cloning-zero-shot/baf1ef41-36b6-428c-9bdf-50ba54682bd8/original/manifest.json",
"voiceSpeed": 1.2,
"ttsModel": "PlayHT2.0-turbo",
"displayName": "My Agent",
"description": "My agent is the best agent",
"greeting": "Hello! How can I help you today?",
"prompt": "You are an agent for a company that sells widgets. A customer calls in and asks about the different types of widgets you sell. You should respond by telling the customer about the different types of widgets you sell and how they differ from each other.\n",
"criticalKnowledge": "We have been in business for 20 years and have sold over 1 million widgets. Currently, we have 3 types of widgets: the standard widget, the deluxe widget, and the super widget. The standard widget is our most popular widget and is the most affordable. The deluxe widget is our mid-range widget and is popular with customers who want a little more than the standard widget. The super widget is our top of the line widget and is popular with customers who want the best of the best.",
"answerOnlyFromCriticalKnowledge": false,
"visibility": "public",
"language": "english",
"llm": null,
"actions": [
"f0gZrOKBKL7veJ6o1M"
]
}'
{
"id": "f0gZrOKBKL7veJ6o1M",
"voice": "s3://voice-cloning-zero-shot/baf1ef41-36b6-428c-9bdf-50ba54682bd8/original/manifest.json",
"voiceSpeed": 1.2,
"ttsModel": "PlayHT2.0-turbo",
"displayName": "My Agent",
"description": "My agent is the best agent",
"greeting": "Hello! How can I help you today?",
"prompt": "You are an agent for a company that sells widgets. A customer calls in and asks about the different types of widgets you sell. You should respond by telling the customer about the different types of widgets you sell and how they differ from each other.\n",
"criticalKnowledge": "We have been in business for 20 years and have sold over 1 million widgets. Currently, we have 3 types of widgets: the standard widget, the deluxe widget, and the super widget. The standard widget is our most popular widget and is the most affordable. The deluxe widget is our mid-range widget and is popular with customers who want a little more than the standard widget. The super widget is our top of the line widget and is popular with customers who want the best of the best.",
"answerOnlyFromCriticalKnowledge": false,
"visibility": "public",
"language": "english",
"llm": null,
"avatarPhotoUrl": "https://api.play.ai/api/v1/agents/as43.../avatar-photo",
"criticalKnowledgeFiles": [
{
"id": "e0e92064e26257fed1477465...",
"name": "whatever you want.pdf",
"url": "https://api.play.ai/api/v1/agents/as43.../critical-knowledge-files/e0e92...",
"size": 108439,
"type": "pdf"
}
],
"phoneNumbers": [
{
"phoneNumber": 13659874563,
"country": "US",
"locality": "Malibu"
}
],
"actions": [
"f0gZrOKBKL7veJ6o1M"
]
}