---
title: "Ingest an analyzed Retell call"
method: POST
path: "/api/voice/v1/webhooks/retell"
tags: ["SDK"]
---

# Ingest an analyzed Retell call

`POST /api/voice/v1/webhooks/retell`

## Request

- Base URL: `https://api.agnost.ai`
- URL: `https://api.agnost.ai/api/voice/v1/webhooks/retell`
- Auth: none declared

Translates a Retell `call_analyzed` webhook into one Agnost voice
conversation. Other Retell event types are acknowledged without capture.
Word timestamps, post-call analysis, call latency, cost, and tool calls
are retained when present. Retell's call access token is never stored.

## Query parameters

- `org_id` string, uuid, required

## Request body

- object
  - `event` string, required
  - `event_timestamp` integer
  - `call` object, required
    - `call_id` string, required
    - `call_type` string
    - `agent_id` string
    - `agent_name` string
    - `start_timestamp` integer
    - `end_timestamp` integer
    - `duration_ms` number
    - `transcript` string
    - `transcript_object` object[]
    - `transcript_with_tool_calls` object[]
    - `call_analysis` object
    - `call_cost` object

## Response `200`

Analyzed call accepted and translated into a conversation.

- object
  - `status` 'accepted', required
  - `session_id` string, required
  - `user_id` string, required
  - `event_count` integer, required

## Other responses

- `204`: Event acknowledged without ingestion.
- `400`: Invalid organization ID or malformed Retell envelope.
- `413`: Transcript exceeds the one-megabyte ingestion limit.
- `422`: Retell data could not be normalized.
- `502`: Downstream Agnost ingestion failed.

## Changes

- **2026-11-03** `a61431b48f36`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agnost/apis/agnost-ai-api/changes/api/voice/v1/webhooks/retell/post.md)

---

[API](https://skmtc.dev/agnost/apis/agnost-ai-api.md) - [All operations](https://skmtc.dev/agnost/apis/agnost-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agnost/apis/agnost-ai-api/revisions/a61431b48f36?raw)