List agents

Required scope: convai:read

Responses

application/json
400

Invalid request parameters
application/json
500

Internal server error

get/agents

curl https://api.simwood.com/convai/v1/agents \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

[
  {
    "id": "string",
    "name": "string",
    "configuration": {
      "asr": {
        "keywords": [
          "string"
        ]
      },
      "turn": {
        "timeout_seconds": 1,
        "silence_timeout_seconds": 1
      },
      "tts": {
        "voice_id": "string",
        "settings": {
          "stability": 1,
          "similarity_boost": 1,
          "speed": 1
        }
      },
      "agent": {
        "first_message": "string",
        "language": "string",
        "prompt": {
          "text": "string",
          "temperature": 1,
          "model": "string"
        },
        "knowledge_base": [
          {
            "type": "url",
            "source": "string",
            "id": "string"
          }
        ]
      },
      "conversation": {
        "max_duration_seconds": 1
      },
      "analysis": {
        "data_collection": {
          "additionalProperty": {
            "type": "boolean",
            "description": "string",
            "dynamic_variable": "string",
            "constant_value": "string"
          }
        }
      }
    },
    "created_at": "2026-07-18T10:26:52.854Z",
    "updated_at": "2026-07-18T10:26:52.854Z"
  }
]

List of agents