Jelliu API documentation

{
  "data": {
    "messages": [
      {
        "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "conversation_id": "3f1c2a9e-5b7d-4e8f-9a01-2c3d4e5f6a7b",
        "tenant_id": "9b2e4d1a-7c3f-4a8e-b5d6-1f0e2c3a4b5d",
        "role": "user",
        "content_type": "image",
        "content": "¿Me pueden cotizar este modelo? Necesito 40 unidades.",
        "audio_url": null,
        "metadata": {
          "attachment": {
            "bytes": 184233,
            "content_type": "image/jpeg",
            "filename": "foto-producto.jpg"
          },
          "inbound_message_id": "SM9f8e7d6c5b4a39281706f5e4d3c2b1a0"
        },
        "created_at": "2026-09-14T16:44:58.000Z",
        "attachment": {
          "filename": "foto-producto.jpg",
          "contentType": "image/jpeg",
          "bytes": 184233
        }
      },
      {
        "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
        "conversation_id": "3f1c2a9e-5b7d-4e8f-9a01-2c3d4e5f6a7b",
        "tenant_id": "9b2e4d1a-7c3f-4a8e-b5d6-1f0e2c3a4b5d",
        "role": "agent",
        "content_type": "text",
        "content": "Claro, con gusto. ¿Para qué fecha necesitas las 40 unidades?",
        "audio_url": null,
        "metadata": {},
        "created_at": "2026-09-14T16:45:03.000Z",
        "attachment": null
      }
    ],
    "id": "3f1c2a9e-5b7d-4e8f-9a01-2c3d4e5f6a7b",
    "tenant_id": "9b2e4d1a-7c3f-4a8e-b5d6-1f0e2c3a4b5d",
    "agent_id": "c4a7e2f1-8b3d-4e6a-9f0c-5d2b1a3e7c9f",
    "contact_id": "7d6c5b4a-3f2e-4d1c-8b9a-0e1f2a3b4c5d",
    "channel": "whatsapp",
    "external_id": "wa_5e8a1c2d-4b6f-4a3e-9d7c-0b1a2f3e4d5c_+573001234567",
    "status": "active",
    "metadata": {},
    "created_at": "2026-09-14T16:40:11.000Z",
    "updated_at": "2026-09-14T16:45:03.000Z",
    "closed_at": null,
    "last_inbound_at": "2026-09-14T16:44:58.000Z",
    "needs_human_at": null,
    "needs_human_reason": null,
    "needs_human_resolved_at": null,
    "summary": null,
    "sentiment_score": null,
    "frustration_score": null,
    "sentiment_low": null,
    "outcome": null,
    "evaluation_criteria_results": {},
    "data_collection_results": {},
    "analysis_fetched_at": null,
    "analysis_attempts": 0,
    "cost_credits": null,
    "cost_usd": null,
    "termination_reason": null,
    "main_language": null,
    "call_success_score": null,
    "tool_call_count": null,
    "mcp_call_count": null,
    "rag_lookup_count": null,
    "tool_result_bytes": null,
    "contact_name": "María Fernanda Rojas",
    "contact_phone": "+573001234567",
    "contact_status": "pending",
    "agent_name": "Asesora comercial",
    "last_message": "Claro, con gusto. ¿Para qué fecha necesitas las 40 unidades?",
    "last_message_at": "2026-09-14T16:45:03.000Z",
    "last_message_role": "agent",
    "qualification": null
  }
}

Returns one conversation of the workspace, active or closed, with the same joined fields as GET /api/conversations plus messages: the first 50 messages of the thread in chronological order (created_at ascending). Longer threads are truncated at 50.

Message content is cleaned for display: the delimiter tags wrapped around customer text before it reaches the model (e.g. <user_message>) are stripped. Each message also carries attachment, the name, type and size of a file the contact sent, or null. File bytes are never stored.

Consistency. Cached for up to 30 seconds. An operator reply through POST /api/conversations/{conversationId}/messages clears the cache immediately. Resolving a human-help request does not, so needs_human_resolved_at can lag for up to 30 seconds.

Access

Required scope: read (or write).
Rate limit: General API — 120 requests/min per workspace (Starter), 200 (Growth), 300 (Business), 600 (Enterprise). See Rate limits.
Plan: Available on every plan.

Returns one conversation of the workspace, active or closed, with the same joined fields as `GET /api/conversations` plus `messages`: the **first 50** messages of the thread in chronological order (`created_at` ascending). Longer threads are truncated at 50. Message content is cleaned for display: the delimiter tags wrapped around customer text before it reaches the model (e.g. `<user_message>`) are stripped. Each message also carries `attachment`, the name, type and size of a file the contact sent, or `null`. File bytes are never stored. **Consistency.** Cached for up to 30 seconds. An operator reply through `POST /api/conversations/{conversationId}/messages` clears the cache immediately. Resolving a human-help request does not, so `needs_human_resolved_at` can lag for up to 30 seconds. **Access** - **Required scope:** `read` (or `write`). - **Rate limit:** General API — 120 requests/min per workspace (Starter), 200 (Growth), 300 (Business), 600 (Enterprise). See [Rate limits](/rate-limits). - **Plan:** Available on every plan.

Authentication

AuthorizationBearer

Workspace API key: jl_ followed by 64 lowercase hex characters, created by the workspace owner in the dashboard (Settings → API Keys) and sent as Authorization: Bearer jl_.... The plaintext is shown once, at creation; Jelliu stores only a SHA-256 hash. A workspace can hold up to 25 active keys.

Scope	GET / HEAD	POST / PUT / PATCH / DELETE	Admin-only routes
`read`	Yes	No	No
`write`	Yes	Yes	No
`full`	Yes	Yes	Yes

Operations restricted to admins or owners reject keys without the full scope with 403, and say so in their description. No key, whatever its scope, can mint or revoke API keys or rotate a webhook secret — that requires a signed-in owner session. A revoked key stops authenticating within about 10 seconds. See Authentication.

Workspace API key: `jl_` followed by 64 lowercase hex characters, created by the workspace owner in the dashboard (**Settings → API Keys**) and sent as `Authorization: Bearer jl_...`. The plaintext is shown once, at creation; Jelliu stores only a SHA-256 hash. A workspace can hold up to 25 active keys. | Scope | GET / HEAD | POST / PUT / PATCH / DELETE | Admin-only routes | | --- | --- | --- | --- | | `read` | Yes | No | No | | `write` | Yes | Yes | No | | `full` | Yes | Yes | Yes | Operations restricted to admins or owners reject keys without the `full` scope with `403`, and say so in their description. No key, whatever its scope, can mint or revoke API keys or rotate a webhook secret — that requires a signed-in owner session. A revoked key stops authenticating within about 10 seconds. See [Authentication](/authentication).

Path parameters

conversationIdstringRequiredformat: "uuid"

Id of the conversation. A value that is not a UUID returns 400.

Response

The conversation and its first 50 messages.

dataobject

A text conversation (WhatsApp, email, webchat, Instagram or Messenger) as returned by GET /api/conversations and GET /api/conversations/{conversationId}. Fields are the conversations row (snake_case) plus contact, agent and last-message columns joined in, and a derived qualification. Analysis and telemetry columns are null until the conversation has been analysed. null means not measured, never zero or neutral.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

Access

Required scope: read (or write).
Rate limit: General API — 120 requests/min per workspace (Starter), 200 (Growth), 300 (Business), 600 (Enterprise). See Rate limits.
Plan: Available on every plan.