GET /v1/agents/{id}: Get AI Agent Details

Use this endpoint to fetch the complete configuration of a single AI agent by its ID. The response includes every setting that governs how the agent communicates — its tone, the topics it is permitted to discuss, the conditions under which it hands off to a human seller, and the cadence it follows when sending automated follow-ups.

Endpoint

GET https://platform-api.deltalead.ai/v1/agents/{id}

Path Parameters

string

required

The unique identifier of the agent to retrieve, e.g. agent_abc123.

Example Request

cURL

curl https://platform-api.deltalead.ai/v1/agents/agent_abc123 \
  -H "X-API-Key: YOUR_API_KEY"

Response

string

Unique identifier for the agent.

string

ID of the organization this agent belongs to.

string

Display name of the agent.

string

Current status: active, inactive, or draft.

string

Language locale the agent uses: es-AR, es-MX, es-CR, es-CO, pt-BR, or en-US.

array

Channels the agent is assigned to: whatsapp, facebook, instagram, web, email, or phone.

string

ISO 8601 timestamp of agent creation.

string

ISO 8601 timestamp of the most recent update.

object

Full behavioral configuration for the agent.

Show Configuration fields

string

Conversational tone used by the agent: formal, friendly, or professional.

array

List of topics or situations that cause the agent to transfer the conversation to a human seller, e.g. "pricing negotiation" or "financing".

array

List of topics the agent is permitted to discuss, e.g. "vehicle availability" or "test drive scheduling".

object

Settings that control automated follow-up messages.

Show Follow-up cadence fields

integer

Maximum number of follow-up messages the agent will send per lead.

integer

Number of days to wait between each follow-up message.

string

Channel used to send follow-up messages, e.g. whatsapp.

200 OK

{
  "id": "agent_abc123",
  "organization_id": "org_xyz789",
  "name": "Martín de Ventas",
  "status": "active",
  "language": "es-AR",
  "channels": ["whatsapp", "instagram"],
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-10-01T08:30:00Z",
  "configuration": {
    "tone": "friendly",
    "handoff_triggers": [
      "pricing negotiation",
      "financing",
      "trade-in valuation"
    ],
    "allowed_topics": [
      "vehicle availability",
      "pricing",
      "test drive scheduling",
      "financing options"
    ],
    "follow_up_cadence": {
      "max_follow_ups": 5,
      "interval_days": 3,
      "channel": "whatsapp"
    }
  }
}

Error Responses

404 Not Found

{
  "error": "not_found",
  "message": "No agent with ID agent_abc123 exists in your organization."
}

Overview

Leads

Conversations

Agents

Webhooks

GET /v1/agents/{id}: Get AI Agent Details | DeltaLead

Endpoint

Path Parameters

Example Request

Response

Error Responses

​Endpoint

​Path Parameters

​Example Request

​Response

​Error Responses

Endpoint

Path Parameters

Example Request

Response

Error Responses