v1

latestOpenAPI 3.0.32026-07-24106305257.4 KB
Agents

Get an Agent

Returns details for a specific Agent.

get/agents/{id}

Path parameters

idstring required

Agent Id

Response

OK

idstring required

Id of agent

preview_descriptionstring

Description of the agent

provider'd-id-agents'

The provider of the agent

starter_messagestring[]

List of messages to be showen as chat starter questions for the user to ask

greetingsstring[]

Greeting messages for the agent One greeting is randomly displayed at the start of the chat

client_keystring

Auto-generated scoped client key for the agent

embedboolean required

Example response

{
  "presenter": {
    "voice": {
      "voice_id": "en-US-JennyNeural",
      "voice_config": {
        "rate": "0.5",
        "pitch": "+2st"
      },
      "language": "English (United States)"
    }
  },
  "llm": {
    "prompt_customization": {
      "role": "Salesperson",
      "topics_to_avoid": [
        "Politics",
        "Religion"
      ],
      "max_response_length": 75
    }
  },
  "triggers": {
    "chat/end": {
      "webhooks": [
        {
          "url": "https://example.com"
        }
      ]
    }
  },
  "pronunciation_dictionary": {
    "id": "dict_V1StGXR8_Z5jdHi6B-myT"
  }
}