Jelliu API documentation

{
  "data": [
    {
      "id": "1d2c3b4a-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "tenant_id": "2d9f6c1e-3b4a-4c5d-9e8f-7a6b5c4d3e2f",
      "agent_id": "7c1e4b2a-9d3f-4e8a-b5c6-2f1a0d9e8b7c",
      "name": "Variante A — consultiva",
      "system_prompt": "Eres Sofía, asesora de Cafés del Huila. Pregunta primero cuánto café consume el cliente al mes antes de recomendar un plan.",
      "first_message": null,
      "weight": 50,
      "is_active": true,
      "total_calls": 47,
      "total_conversions": 6,
      "total_duration_seconds": 7285,
      "avg_sentiment": 0.18,
      "created_at": "2026-09-02T10:15:00.000Z",
      "updated_at": "2026-09-14T21:40:12.000Z"
    },
    {
      "id": "8e7f6a5b-4c3d-4e2f-9a1b-0c9d8e7f6a5b",
      "tenant_id": "2d9f6c1e-3b4a-4c5d-9e8f-7a6b5c4d3e2f",
      "agent_id": "7c1e4b2a-9d3f-4e8a-b5c6-2f1a0d9e8b7c",
      "name": "Variante B — oferta directa",
      "system_prompt": "Eres Sofía, asesora de Cafés del Huila. Presenta la oferta del plan anual en la primera respuesta.",
      "first_message": "Hola, le habla Sofía de Cafés del Huila. Este mes el plan anual tiene dos meses gratis.",
      "weight": 50,
      "is_active": true,
      "total_calls": 42,
      "total_conversions": 9,
      "total_duration_seconds": 5796,
      "avg_sentiment": 0.31,
      "created_at": "2026-09-02T10:16:30.000Z",
      "updated_at": "2026-09-14T21:52:03.000Z"
    }
  ]
}

Lists the agent’s live prompt variants, oldest first, with their raw counters. Deleted variants are not returned. For conversion rates and confidence intervals use GET /api/agents/{agentId}/ab-tests/results.

Returns an empty list — not 404 — when the agent does not exist in the workspace.

Consistency. Cached for up to 120 seconds; variant writes through this API clear it immediately, but counters updated by finished calls can take up to 120 seconds to show.

Access

Required scope: read.
Rate limit: General API — 120 (Starter), 200 (Growth), 300 (Business) or 600 (Enterprise) requests/min per workspace; requests under this path are counted twice against it because two overlapping mounts apply the limiter. See Rate limits.
Plan: A/B testing is gated by plan feature; every plan includes it today.

Lists the agent's live prompt variants, oldest first, with their raw counters. Deleted variants are not returned. For conversion rates and confidence intervals use `GET /api/agents/{agentId}/ab-tests/results`. Returns an empty list — not `404` — when the agent does not exist in the workspace. **Consistency.** Cached for up to 120 seconds; variant writes through this API clear it immediately, but counters updated by finished calls can take up to 120 seconds to show. **Access** - **Required scope:** `read`. - **Rate limit:** General API — 120 (Starter), 200 (Growth), 300 (Business) or 600 (Enterprise) requests/min per workspace; requests under this path are counted twice against it because two overlapping mounts apply the limiter. See [Rate limits](/rate-limits). - **Plan:** A/B testing is gated by plan feature; every plan includes it today.

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

agentIdstringRequiredformat: "uuid"

UUID of the agent. An unknown id or one from another workspace returns an empty list; a value that is not a UUID answers 400.

Response

Variants, oldest first.

datalist of objects

Live variants of the agent. Empty when none exist or the agent is unknown.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

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