API de Chat Shares

La API de Chat Shares permite compartir sesiones de AI chat como link público read-only — p. ej. para review de cliente o como evidencia de un análisis del Master Agent. El owner crea vía /v1/chat-shares, el destinatario lee vía /share/{token} (público, noindex). Documentación completa del módulo: Agentic Chat.

Todos los endpoints API autenticados con Sanctum, scope al team.

Endpoints

POST /v1/chat-shares

Body:

Al menos una opción show_* debe ser true, si no la API devuelve 422.

curl -X POST "$BASE/chat-shares" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
    "session_id": 42,
    "title": "Backlinks-Analyse fuer Kunde X",
    "expires_at": "2026-06-01T00:00:00Z",
    "show_tool_results": true
  }'

Response 201:

{
  "data": {
    "id": 1,
    "token": "f3a9b2c4...",
    "url": "https://rankion.ai/share/f3a9b2c4...",
    "title": "Backlinks-Analyse fuer Kunde X",
    "session_id": 42,
    "expires_at": "2026-06-01T00:00:00Z",
    "frozen_at": null,
    "has_password": false,
    "max_views": null,
    "view_count": 0,
    "unique_viewer_count": 0,
    "last_viewed_at": null,
    "revoked_at": null,
    "status": "active",
    "show_user_messages": true,
    "show_assistant_messages": true,
    "show_tool_results": true,
    "created_at": "2026-05-01T09:14:01Z"
  }
}

PATCH /v1/chat-shares/{id}

Acepta los mismos campos que POST más freeze: bool:

• freeze: true — congela el snapshot de contenido. Los cambios posteriores en la sesión origen ya no se ven en el share.
• freeze: false — vuelve a live; el share refleja de nuevo la sesión actual.

DELETE /v1/chat-shares/{id}

Soft revoke. Asigna revoked_at — el public link entrega a partir de ese momento 410 Gone. La fila permanece 90 días en la BD (configurable vía CHAT_SHARES_RETENTION_DAYS), luego un job daily prune la borra definitivamente.

Public route (NO está en la API)

Estas rutas no viven bajo /api/v1/ — son HTML público:

Estadísticas y view log

GET /v1/chat-shares/{id}/views entrega el histórico de views anonimizado por GDPR — IP hash, user agent family, referrer domain, timestamp. Sin datos personales.

curl "$BASE/chat-shares/1/views?per_page=50" \
  -H "Authorization: Bearer $TOKEN" | jq '.data[] | {viewed_at, ua_family, referrer_domain}'

Códigos de status

Pitfalls

• show_tool_results=false es default. Por defecto el destinatario no ve cards de tool call — solo la conversación. Actívalo cuando quieras compartir, p. ej., datos SERP o tablas de backlinks.
• freeze no es reversible sin PATCH. Una vez congelado, el snapshot queda fijo — aunque la sesión continúe.
• El public link no se revoca por token. La revocación va solo vía DELETE /v1/chat-shares/{id} con auth token del owner.
• El throttle de password es duro. 6+ intentos fallidos / minuto → 429 durante 60 s; un segundo intento de bypass alarga el lockout.

Relacionado: Agentic Chat · API de Agentic Plans · API de Auth.