# Deyaho API

**Canonical:** https://apis.io/apis/deyaho-com/deyaho-com-api/  
**Provider:** Deyaho — https://apis.io/providers/deyaho-com/  
**Documentation:** https://apidocs.deyaho.com/api-docs

Deyaho API is published by [Deyaho](https://apis.io/providers/deyaho-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Deyaho API as documented publicly: 34 operations. Contract generated from the documentation by API Evangelist (2026-11-05); not the provider's own document.

## Operations (34)

| Method | Path | Summary |
|---|---|---|
| GET | `/agents` | Los agentes de tu cuenta. |
| POST | `/agents` | Crea un agente para un cliente. |
| DELETE | `/agents/{id}` | Borra un agente de tu cuenta (soft-delete, igual que el panel). |
| PATCH | `/agents/{id}` | Modifica la configuracion (solo los campos que envies). |
| POST | `/agents/{id}/channels` | Activa o desactiva un canal de un agente. |
| POST | `/agents/{id}/kb-files` | Sube un documento a la base de conocimiento. |
| GET | `/api/v1/agents` | Los agentes de tu cuenta. |
| POST | `/api/v1/agents` | POST /api/v1/agents |
| GET | `/api/v1/agents/ckq1` | Detalle de un agente específico. |
| GET | `/api/v1/appointments` | Citas de tus agentes, guardadas en Deyaho y aisladas por tu cuenta. |
| GET | `/api/v1/calls` | Llamadas de tus agentes, entrantes y salientes en el mismo listado , cada una con su direction ( inbound / outbound ). |
| GET | `/api/v1/calls/pc_ckz9.../recording` | Devuelve un enlace temporal firmado a la grabacion (caduca en 300 s). |
| GET | `/api/v1/calls/pc_ckz9.../transcript` | Transcripcion de una llamada de voz. |
| GET | `/api/v1/conversations` | GET /api/v1/conversations |
| GET | `/api/v1/costs` | Facturacion real de Stripe de tu cuenta. |
| GET | `/api/v1/errors` | Eventos de error y fallo de tu cuenta. |
| GET | `/api/v1/exclusions` | lista tu exclusion y opt-out. |
| GET | `/api/v1/export` | Exportacion completa en JSON, bajo demanda. |
| GET | `/api/v1/usage` | Consumo del periodo: minutos de voz, mensajes de texto y conversaciones. |
| GET | `/appointments` | Citas de tus agentes, guardadas en Deyaho y aisladas por tu cuenta. |
| GET | `/calls` | Llamadas de tus agentes, entrantes y salientes en el mismo listado , cada una con su direction ( inbound / outbound ). |
| GET | `/calls/{id}/recording` | Devuelve un enlace temporal firmado a la grabacion (caduca en 300 s), solo si el cliente tiene las grabaciones habilitadas en ese agente. |
| GET | `/calls/{id}/transcript` | Transcripcion de una llamada de voz. |
| POST | `/clients` | Entrega un agente a un cliente final con su propio acceso. |
| GET | `/conversations` | Lista las conversaciones (WhatsApp y chat web) de tus agentes, mas recientes primero. |
| GET | `/conversations/{id}` | Una conversacion con todos sus mensajes (orden cronologico). |
| GET | `/costs` | Facturacion real de Stripe de tu cuenta: lo que se te cobra por periodo, para que cuadre al centimo con tu factura. |
| GET | `/errors` | Eventos de error y fallo de tu cuenta, reunidos de varias fuentes: llamadas de campana fallidas ( call_failure ), agentes en fallo ( agent_failure ) y entreg... |
| GET | `/exclusions` | Lista tu exclusion y opt-out. |
| GET | `/export` | Exportacion completa en JSON, bajo demanda: configuracion de agentes con su base de conocimiento, conversaciones con mensajes, leads, citas y llamadas. |
| POST | `/integrations/telegram` | Conecta un bot de Telegram a un agente. |
| PUT | `/integrations/webhook` | Configura tu endpoint de webhooks. |
| GET | `/leads` | Contactos de WhatsApp de tus agentes con su estado de cualificacion: new (sin respuesta aun del agente), engaged (el agente ya respondio), human_handoff (pas... |
| GET | `/usage` | Consumo del periodo: minutos de voz, mensajes de texto y conversaciones. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/deyaho-com/openapi/_ae-authored/deyaho-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/deyaho-com/json-schema/deyaho-com-patch-agents-id-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/deyaho-com/json-schema/deyaho-com-post-agents-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/deyaho-com/json-schema/deyaho-com-get-api-v1-agents-ckq1-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/deyaho-com/json-schema/deyaho-com-get-api-v1-export-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/deyaho-com/json-schema/deyaho-com-get-export-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/deyaho-com/json-schema/deyaho-com-put-integrations-webhook-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/deyaho-com/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/deyaho-com/deyaho-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/deyaho-com/.