Get Agent

Fetch the full configuration of a single agent by its ID.

GET /agents2/{id}

Get an agent

cURL

curl --request GET \
  --url https://api.dialnexa.com/v1/agents2/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "agt_abc123",
  "organization_id": "org_xyz",
  "folder_id": null,
  "current_version_number": 1,
  "is_deleted": false,
  "createdAt": "2024-03-01T10:00:00.000Z",
  "updatedAt": "2024-03-01T10:00:00.000Z",
  "timezone": null,
  "current_version": {
    "agent_id": "agt_abc123",
    "number": 1,
    "title": "Customer Support Bot",
    "is_published": true,
    "language": {
      "id": "lang_en_us",
      "details": {
        "name": "English",
        "code": "en-US"
      }
    },
    "conversation_start_type": "agent",
    "allow_interruptions": true,
    "prompts": {
      "prompt_text": "You are a helpful customer support agent for Acme Corp. Assist customers with billing inquiries, order status, and returns.",
      "welcome_message": "Hello! How can I help you today?",
      "node_positions": null,
      "json_output_instructions": null,
      "default_dynamic_variables": null
    },
    "voice": {
      "id": "voice_xyz",
      "model_id": "vmod_abc",
      "settings": {
        "speed": 1,
        "temperature": 0.8,
        "volume": 1,
        "pitch": null,
        "fallback_voices": [],
        "pronunciations": []
      }
    },
    "llm": {
      "id": "llm_gpt4o",
      "settings": {
        "temperature": 0.1,
        "structured_output": true
      },
      "fallback": {
        "fallback_llm_enabled": null,
        "llm_fallback_delay_ms": null,
        "llm_fallback_model": null
      }
    },
    "telephony": {
      "inbound": {
        "id": "phn_abc",
        "details": null
      },
      "outbound": {
        "id": null,
        "details": null
      },
      "call_limits": {
        "end_call_on_silence_sec": 180,
        "max_call_duration_sec": 600,
        "pause_before_speaking_sec": 1.5,
        "ring_duration_sec": 30
      }
    },
    "speech": {
      "background_sound": null,
      "responsiveness": 0.5,
      "interruption_sensitivity": 0.5,
      "backchanneling": false,
      "backchannel_frequency": 0.5,
      "transcription_mode": "optimize_for_speed",
      "denoising_mode": "remove_noise",
      "speech_normalization": false,
      "transcript_formatting": false,
      "transcriber_id": "tr0deepnova3xx",
      "fallback_stt_enabled": false,
      "stt_fallback_transcriber_id": "tr0soniox001xx",
      "stt_fallback_wait_ms": 500,
      "audio_cache_enabled": true
    },
    "reminders": {
      "reminder_message_interval": 10,
      "reminder_message_frequency": 1
    },
    "security": {
      "opt_out_sensitive_data_storage": false,
      "opt_in_secure_urls": false
    },
    "analysis": {
      "postcall_analysis": []
    },
    "functions": [],
    "transcriber_id": "tr0deepnova3xx",
    "fallback_stt_enabled": false,
    "stt_fallback_transcriber_id": "tr0soniox001xx",
    "stt_fallback_wait_ms": 500,
    "audio_cache_enabled": true
  },
  "pipeline_type": "Cascaded"
}

Fetches the complete configuration of an agent including its voice, LLM, prompts, telephony limits, and post-call analysis settings.

When to use this

Use this to display agent details in a management dashboard, verify settings before starting a campaign, or check the current configuration of an agent before updating it.

Request

curl "https://api.dialnexa.com/v1/agents2/agt_k7m2nq9xw4p8" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "agt_k7m2nq9xw4p8",
  "title": "Sales Qualifier",
  "conversation_start_type": "agent",
  "allow_interruptions": true,
  "is_published": true,
  "prompts": {
    "prompt_text": "You are a friendly sales rep for Acme Corp. Qualify the caller for the enterprise plan. The caller name is {{customer_name}}.",
    "welcome_message": "Hi {{customer_name}}, thanks for calling Acme Corp!"
  },
  "voice": { "id": "vce_en_us_ava", "model_id": "eleven_multilingual_v2" },
  "llm":   { "id": "llm_gpt4o",     "settings": { "temperature": 0.7 } },
  "telephony": {
    "call_limits": { "max_call_duration_sec": 480, "end_call_on_silence_sec": 120, "ring_duration_sec": 30 }
  },
  "analysis": {
    "postcall_analysis": [
      { "field_name": "qualified",         "field_type": "BOOLEAN" },
      { "field_name": "follow_up_booked",  "field_type": "BOOLEAN" }
    ]
  },
  "created_at": "2024-03-01T10:00:00.000Z",
  "updated_at": "2024-05-01T09:30:00.000Z"
}

Authorizations

Authorization · string · header · required

Pass your API key as a Bearer token in the Authorization header.

Path Parameters

id · string · required

Response

200

application/json

Success.

id · string

Example:

"agt_abc123"

organization_id · string

Example:

"org_xyz"

folder_id · string | null

Example:

null

current_version_number · integer

Example:

1

is_deleted · boolean

Example:

false

createdAt · string<date-time>

Example:

"2024-03-01T10:00:00.000Z"

updatedAt · string<date-time>

Example:

"2024-03-01T10:00:00.000Z"

timezone · string | null

Example:

null

current_version · object

Show child attributes

pipeline_type · enum<string> | null

Pipeline subtype for single prompt agents. Cascaded uses separate STT, LLM, and TTS components. Speech_To_Speech uses a realtime speech model.

Available options: Cascaded, Speech_To_Speech

Example:

"Cascaded"