PATCH
/
api
/
v1
/
agents
/
{agentId}

Updates the properties of the agent with the specified ID.

Authorizations

AUTHORIZATION
string
header
required

API key required for this endpoint. Use Bearer YOUR_SECRET_API_KEY. Get your key from https://play.ai/developers.

X-USER-ID
string
header
required

User ID required for this endpoint. Get it from https://play.ai/developers.

Headers

content-type
enum<string>
required
Available options:
application/json
accept
enum<string>
Available options:
application/json

Path Parameters

agentId
string
required

The agent's ID.

Body

application/json
actions
any
answerOnlyFromCriticalKnowledge
any
criticalKnowledge
any
description
any
displayName
any
greeting
any
llm
any
prompt
any
visibility
any
voice
any
voiceSpeed
any

Response

200 - application/json
answerOnlyFromCriticalKnowledge
boolean
default:
false
required

If true, the agent will only respond with information from the critical knowledge field.

criticalKnowledgeFiles
object[]
required
description
string
required

The agent's description

Maximum length: 500
displayName
string
required

The agent's name

Maximum length: 250
id
string
required

The unique ID for each agent.

phoneNumbers
object[]
required
visibility
enum<string>
default:
public
required

The visibility of the agent

Available options:
public,
private
voice
string
required

The unique ID for a PlayAI Voice.

actions
string[]
avatarPhotoUrl
string | null

The URL of the agent's avatar photo

criticalKnowledge
string | null

The agent's critical knowledge

Maximum length: 20000
greeting
string | null

The greeting message for the agent

Maximum length: 250
llm
object | null

Leave this field out or null if you don't want the agent to use your custom LLM API. See Bring Your Own LLM for more info.

prompt
string | null

The greeting message for the agent

Maximum length: 10000
voiceSpeed
number | null

The voice speed, i.e. how fast is the agent's speech. Possible values are: 0.5, 0.6, 0.7, 0.8, 0.9, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5.