Claude Platform Docs
AdministraciónAPI de cumplimiento

Recuperar transcripciones de sesiones

Lista las sesiones que tus usuarios ejecutan en las aplicaciones y agentes de Claude, como Claude Cowork y Claude Code, y recupera sus transcripciones mediante la Compliance API.

Los endpoints de esta página exponen las transcripciones de sesiones de tus organizaciones de Claude Enterprise a los revisores de cumplimiento. Las transcripciones cubren las sesiones que tus usuarios ejecutan en aplicaciones y agentes de Claude (Cowork, Claude Code, Claude Science, Claude for Microsoft 365, los complementos de Claude para Google Docs, Google Sheets y Google Slides, Claude in Chrome y Claude Tag). Cada sesión es una única conversación con Claude; su transcripción es la secuencia de prompts del usuario, respuestas del asistente y llamadas y resultados de herramientas en esa conversación. Los endpoints admiten exportaciones de “eDiscovery” (descubrimiento electrónico) y la aplicación de “data loss prevention” (prevención de pérdida de datos), o DLP.

La Compliance API agrupa las sesiones en dos familias de endpoints según dónde se ejecutan: endpoints de sesiones locales para las sesiones en las máquinas de los usuarios, y endpoints de sesiones remotas para las sesiones que se ejecutan en la nube en entornos administrados por Anthropic o, en el caso de Claude Tag, en un grupo de runners autohospedado. Ambas familias son de solo lectura, y ninguna está disponible para las claves de Admin API (sk-ant-admin01-...): las llamadas autenticadas con una clave de Admin API devuelven 403 Forbidden.

La siguiente tabla relaciona cada producto, y dónde se ejecuta, con la familia de endpoints que devuelve sus sesiones y el valor de product_surface que las identifica en las respuestas.

Producto y dónde se ejecutaFamilia de endpointsproduct_surface
Cowork en Claude Desktop, que se ejecuta en la máquina del usuarioEndpoints de sesiones locales (/v1/compliance/apps/sessions/local)cowork
Claude Code en la terminal, en Claude Desktop o en una extensión de IDE, que se ejecuta en la máquina del usuarioEndpoints de sesiones localesclaude_code
Aplicación de escritorio Claude Science, que se ejecuta en la máquina del usuarioEndpoints de sesiones localesclaude_science
Claude for Microsoft 365 (los complementos de Claude para Excel, PowerPoint, Word y Outlook), que se ejecuta en las aplicaciones de escritorio o web de Microsoft 365Endpoints de sesiones localesoffice_agents/excel, office_agents/powerpoint, office_agents/word u office_agents/outlook
Los complementos de Claude para Google Docs, Google Sheets y Google Slides, que se ejecutan en esas aplicaciones de GoogleEndpoints de sesiones localesoffice_agents/google_docs, office_agents/google_sheets u office_agents/google_slides
Claude in Chrome (el chat integrado de la extensión del navegador), que se ejecuta en la máquina del usuarioEndpoints de sesiones localesclaude_in_chrome
Sesiones de Cowork que se ejecutan en la nube en entornos administrados por Anthropic, incluidas las sesiones iniciadas en claude.ai web o móvil y las ejecuciones en la nube de tareas programadas de CoworkEndpoints de sesiones remotas (/v1/compliance/apps/sessions/remote)cowork_remote
Sesiones de Claude Tag iniciadas en Slack, que se ejecutan en la nube en entornos administrados por Anthropic o en un grupo de runners autohospedadoEndpoints de sesiones remotasclaude_tag

office_agents por sí solo no indica de qué aplicación proviene la sesión, y puede provenir de Claude for Microsoft 365 o de los complementos de Google. Consulta la descripción de product_surface en Sesiones en las máquinas de los usuarios.

La captura de sesiones locales está vinculada a que la Compliance API esté habilitada para tu organización y se aplica mientras los usuarios tienen la sesión iniciada con su cuenta de Claude Enterprise. Los endpoints de sesiones no devuelven lo siguiente:

  • Sesiones de Claude Code autenticadas con una clave de API de Claude Console, o ejecutadas a través de una plataforma en la nube de terceros como Amazon Bedrock, Google Cloud o Microsoft Foundry.
  • Sesiones en la nube de Claude Code (incluidas las tareas programadas en la nube de Claude Code), que se ejecutan en infraestructura en la nube en lugar de en la máquina del usuario. Estas sesiones en la nube no son sesiones remotas, aunque ambas se ejecutan en la nube; los endpoints de sesiones remotas solo devuelven sesiones de Cowork y Claude Tag.
  • Sesiones locales de productos distintos de Cowork y Claude Code en organizaciones con preparación para HIPAA habilitada. En esas organizaciones, los endpoints de sesiones locales solo devuelven sesiones de Cowork y Claude Code, y el contenido de sesión capturado se almacena durante 30 días.
  • Sesiones locales para las que está vigente la “zero data retention” (retención de datos cero), o ZDR. Estas sesiones se excluyen de los resultados de la lista, y los endpoints de recuperación y de mensajes devuelven 404 para ellas.

Anthropic recomienda la Compliance API para recuperar el contenido de las sesiones. La siguiente tabla compara las sesiones locales y las sesiones remotas con las alternativas basadas en OpenTelemetry disponibles para Cowork y Claude Code: el registro de OpenTelemetry de Cowork y la supervisión de Claude Code.

Sesiones locales (en las máquinas de los usuarios)Sesiones remotas (en la nube)Registro de OpenTelemetry
EntregaPull: consulta y exportación por HTTPSPull: consulta y exportación por HTTPSPush: enviado por streaming a tu recolector OTLP
ConfiguraciónFunciona con tu Compliance Access Key existenteFunciona con tu Compliance Access Key existenteEl administrador configura un endpoint OTLP y los ajustes de captura de contenido
InfraestructuraAlojada por AnthropicAlojada por AnthropicTú ejecutas el recolector y el almacenamiento
Prefijo de IDclls_cse_N/A
Valores de product_surfacecowork, claude_code, claude_science, claude_in_chrome y valores que comienzan con office_agentscowork_remote, claude_tagN/A
Retención6 años de forma predeterminada, o el período de retención de conversaciones personalizado de tu organización cuando se establece uno finito; 30 días en organizaciones con preparación para HIPAA habilitada; conservado por AnthropicSin período predeterminado; consulta Retención y eliminación; conservado por AnthropicTu infraestructura, tus políticas
Prompts del usuario y respuestas del asistenteSíSíSí, sujeto a los ajustes de captura de contenido
Entradas de herramientasTruncadas a 10,000 bytes por entrada de forma predeterminada; hasta aproximadamente 1 MiB si se solicitaTruncadas a 10,000 bytes por entrada de forma predeterminada; hasta aproximadamente 1 MiB si se solicitaResúmenes truncados
Contenido de resultados de herramientasCada entrada de texto truncada a 10,000 bytes de forma predeterminada; hasta aproximadamente 1 MiB si se solicitaCada entrada de texto truncada a 10,000 bytes de forma predeterminada; hasta aproximadamente 1 MiB si se solicitaMetadatos como el tamaño y el éxito; Claude Code también puede capturar contenido con un ajuste opcional con límite de tamaño
Contenido de archivosSí, a través de las llamadas a herramientas de la transcripción (solo texto; el resto del contenido aparece como un marcador de posición)Sí, a través de las llamadas a herramientas de la transcripción (solo texto; el resto del contenido se omite)Rutas de archivos; Claude Code también puede capturar el contenido con un ajuste opcional con límite de tamaño
Metadatos del host y del dispositivo (tipo de terminal, rutas del espacio de trabajo)NoNoSí
Uso de tokens y costoNo; disponible a través de la Claude Enterprise Analytics APINo; disponible a través de la Claude Enterprise Analytics APISí

Sesiones en las máquinas de los usuarios (sesiones locales)

Las sesiones locales se ejecutan en las máquinas de los usuarios mientras han iniciado sesión con su cuenta de Claude Enterprise, en los siguientes productos:

  • Cowork en Claude Desktop
  • Claude Code (en la terminal, en Claude Desktop o en una extensión de IDE)
  • La aplicación de escritorio Claude Science
  • Claude for Microsoft 365 (en Excel, PowerPoint, Word y Outlook)
  • Los complementos de Claude para Google Docs, Google Sheets y Google Slides
  • La extensión del navegador Claude in Chrome

La Compliance API expone las sesiones locales a través de tres endpoints: GET /v1/compliance/apps/sessions/local enumera los metadatos de las sesiones, GET /v1/compliance/apps/sessions/local/{session_id} recupera los metadatos de una sesión y GET /v1/compliance/apps/sessions/local/{session_id}/messages devuelve la transcripción de una sesión. Los tres requieren el alcance read:compliance_user_data y solo cuentan para el “rate limit” (límite de velocidad) compartido de la Compliance API; no están sujetos al segundo presupuesto de solicitudes que se aplica a los endpoints de sesiones remotas. Consulta 429 Too Many Requests. Si las sesiones locales no están disponibles para tu organización principal, los tres endpoints devuelven 404 con el mensaje Local sessions are not available. (consulta Sesión local no encontrada); mientras los listados de sesiones o el contenido capturado no estén disponibles temporalmente, devuelven 503 (consulta Sesiones locales temporalmente no disponibles).

Para las sesiones locales, Anthropic registra cada conversación del lado del servidor a medida que sus solicitudes llegan a la Claude API; no se instala nada en el dispositivo y no se recopila nada más allá de las solicitudes que el cliente ya envía a la Claude API. Las transcripciones de sesiones locales muestran lo que se le pidió a Claude que hiciera y lo que devolvió, no lo que ocurrió en el dispositivo. La actividad de archivos y de red solo es visible a través de las llamadas a herramientas y los resultados de herramientas de la transcripción, por lo que la actividad que nunca llega a la API (por ejemplo, archivos locales que la sesión nunca envió) no se captura.

En las organizaciones que usan claves de cifrado administradas por el cliente, las transcripciones de sesiones locales se cifran con tu clave administrada por el cliente y se devuelven como de costumbre. Mientras esa clave no se pueda usar (por ejemplo, porque la deshabilitaste o revocaste, o porque no se puede acceder a ella), el endpoint de mensajes devuelve 503 Service Unavailable para las páginas afectadas en lugar del contenido de la transcripción. Esos mensajes nunca se informan como not_captured (consulta Recuperar la transcripción de una sesión local). Enumerar sesiones y recuperar los metadatos de las sesiones no se ve afectado.

El endpoint de lista devuelve los metadatos de las sesiones, sin contenido de transcripción, de cada organización vinculada que tu clave puede leer. A diferencia de la lista de sesiones remotas, no tiene filtros de organización ni de usuario: acota los resultados en el tiempo con created_at.gte, created_at.gt, created_at.lt y created_at.lte. Cada uno acepta una marca de tiempo RFC 3339 con un desplazamiento UTC obligatorio. Cuando proporcionas un límite inferior y uno superior, el límite superior debe ser posterior al límite inferior (o igual a él, si usas created_at.gte con created_at.lte); de lo contrario, la solicitud devuelve 400 Bad Request. Un filtro de tiempo independiente, updated_at.gte, acota por la última actividad en lugar de la primera: devuelve las sesiones cuya última llamada de inferencia es igual o posterior a la hora indicada y se combina con los filtros created_at sin cambiar el orden ni la paginación. Úsalo para consultar periódicamente las sesiones activas desde una pasada anterior, como se describe más adelante en esta sección. Las sesiones y los mensajes nuevos aparecen en los resultados tras un breve retraso de procesamiento, normalmente en cuestión de minutos; una sesión que falta inmediatamente después de iniciarse no necesariamente está sin capturar. La siguiente solicitud enumera las sesiones creadas desde una fecha determinada.

cURL
curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/sessions/local" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2026-10-21" \
  --data-urlencode "created_at.gte=2026-07-01T00:00:00Z" \
  --data-urlencode "limit=100"
Response
{
  "data": [
    {
      "type": "compliance_local_session",
      "id": "clls_01HxKpLmNoPqRsTuVwXyZaBc",
      "organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
      "workspace_id": "wrkspc_01SvYKoWVRVHoEbwESNvzYdR",
      "user": {
        "id": "user_01GpKpLmNoPqRsTuVwXyZaBc",
        "email_address": "engineer@example.com"
      },
      "product_surface": "cowork",
      "created_at": "2026-07-09T14:02:11Z",
      "updated_at": "2026-07-09T14:02:38Z"
    },
    {
      "type": "compliance_local_session",
      "id": "clls_01HyLqMnOpQrStUvWxYzAbCd",
      "organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
      "workspace_id": null,
      "user": {
        "id": "user_01HqRsTuVwXyZaBcDeFgHiJk",
        "email_address": null
      },
      "product_surface": "claude_code",
      "created_at": "2026-07-08T09:15:43Z",
      "updated_at": "2026-07-08T09:52:10Z"
    }
  ],
  "next_page": "page_AAEfQx7mPdLkq9Rt2VwHbZk"
}

Los resultados se ordenan en orden cronológico inverso (los más recientes primero) por created_at, con los empates resueltos en un orden fijo del lado del servidor, y se limitan a limit resultados por respuesta (100 de forma predeterminada, 500 como máximo). El endpoint pagina solo hacia adelante con los tokens page y next_page (consulta Paginar resultados): pasa el valor next_page de la respuesta como parámetro de consulta page en la siguiente solicitud, y detente cuando next_page sea null. La respuesta no tiene un campo has_more. Completa un recorrido de la lista dentro de las 24 horas posteriores a su inicio; un cursor de lista más antiguo se sigue aceptando, pero se vuelve a evaluar con respecto al límite de retención actual, por lo que se pueden omitir las sesiones cuya actividad retenida más antigua esté a punto de superar el período de retención.

En cada objeto de sesión, user.id siempre está establecido y se conserva tras la eliminación de la cuenta; user.email_address es null cuando la cuenta del usuario se ha eliminado o el usuario ya no es miembro de una organización que tu clave pueda leer. workspace_id es null cuando la sesión no estaba asociada a un espacio de trabajo. Una sesión local corresponde a un ID de sesión del cliente: abrir una nueva conversación en el cliente, o borrar su contexto, inicia un nuevo registro de sesión. En el caso de Claude Science, la lista también puede incluir sesiones independientes para el trabajo en segundo plano propio de la aplicación (por ejemplo, asignar un nombre a la conversación; en versiones más recientes de la aplicación, también sus pistas de revisión y delegación), y en versiones anteriores de la aplicación parte de ese trabajo en segundo plano aparece como mensajes adicionales dentro de la propia transcripción de la conversación. Una conversación de Claude Science que continúa a lo largo de algunas actualizaciones de la aplicación aparece como dos sesiones. Estos comportamientos son esperados. Trata los valores de id como cadenas opacas; el formato puede cambiar sin previo aviso.

En Claude for Microsoft 365 y en los complementos de Claude para Google Docs, Google Sheets y Google Slides, eliminar una conversación en el complemento ocurre solo en el cliente, por lo que no se refleja en la API: las sesiones locales no tienen un campo deleted_at, y la sesión sigue apareciendo en la lista hasta que la retención la elimina.

Las sesiones locales tienen un updated_at pero no un status: una sesión local no tiene un estado de ciclo de vida del lado del servidor, y su visibilidad se rige por la retención. Una sesión local se captura como la serie de llamadas a la Claude API (llamadas de inferencia) que el cliente realiza durante la sesión, y la retención se aplica a cada llamada capturada de forma individual. created_at es la marca de tiempo de la llamada retenida más antigua de la sesión y updated_at la marca de tiempo de la última, ambas en UTC. A medida que las llamadas más antiguas superan el período de retención, created_at avanza en consecuencia, y una vez que todas las llamadas de una sesión han caducado, la sesión deja de devolverse; updated_at sigue la llamada más reciente y no se ve afectado hasta entonces. Como created_at puede cambiar entre ejecuciones, elimina duplicados por id cuando vuelvas a recorrer la lista con el tiempo. Para mantener las transcripciones actualizadas a medida que las sesiones reciben mensajes, consulta periódicamente con el filtro updated_at.gte, superponiendo ventanas consecutivas. En el endpoint de lista, updated_at es un límite inferior: para una sesión que sigue activa en el límite de una página o en el extremo superior de una ventana de created_at, puede ir momentáneamente por detrás de la verdadera última actividad de la sesión, y una nueva llamada solo se puede consultar tras el breve retraso de procesamiento mencionado anteriormente. Debido a ese retraso, establece el updated_at.gte de cada ejecución unos minutos antes de la hora de inicio de tu ejecución anterior, no exactamente en la hora de la ejecución anterior. Un límite establecido exactamente en la hora anterior descarta de forma silenciosa y permanente una sesión cuya última llamada todavía se estaba indexando en ese momento, porque una vez que el límite avanza más allá de esa llamada, ninguna ejecución posterior la devuelve. Elimina duplicados por id en las sesiones devueltas, vuelve a obtener sus transcripciones y elimina duplicados por id en los mensajes. Recuperar una sesión, o sus mensajes, siempre refleja exactamente la última llamada retenida, por lo que una pasada de conciliación periódica sobre una ventana más antigua es una alternativa más exhaustiva que ampliar la superposición.

La lista incluye solo las sesiones con al menos una llamada capturada. Una sesión que terminó antes de que comenzara la captura para tu organización no aparece en la lista. Para una sesión que ya estaba en curso en ese momento, created_at es la hora de su primera llamada capturada. Algunos mensajes de una sesión de la lista aún pueden marcarse como no disponibles, por ejemplo, porque las políticas de manejo de datos de Anthropic retienen su contenido (consulta Recuperar la transcripción de una sesión local).

El contenido de sesiones locales capturado se almacena durante 6 años desde su captura de forma predeterminada. Si la organización que ejecutó la sesión ha establecido un período de retención de conversaciones personalizado finito en claude.ai > Configuración de la organización > Datos y privacidad, se aplica ese período en su lugar, ya sea más corto o más largo que el predeterminado. Solo se aplica un período establecido para los chats o para todos los datos; los períodos establecidos para proyectos o artifacts no afectan a las sesiones locales. Un cambio en ese período surte efecto de dos maneras distintas: los endpoints dejan de devolver la actividad anterior al período actual de la organización en cuanto cambia el ajuste, mientras que cada mensaje capturado se almacena durante el período que estaba vigente cuando se capturó, por lo que alargar el período más adelante no restaura el contenido que ya ha caducado. En las organizaciones con preparación para HIPAA habilitada, el contenido de sesiones locales capturado se almacena durante 30 días desde su captura, o durante el período de retención de conversaciones personalizado de la organización cuando este es más corto; el valor predeterminado de 6 años no se aplica.

Para obtener directamente los metadatos de una sesión, pasa su ID a GET /v1/compliance/apps/sessions/local/{session_id}. La respuesta es el mismo objeto de sesión que devuelve el endpoint de lista, sin envoltorio y sin contenido de transcripción. Un ID de sesión con formato incorrecto devuelve 400 Bad Request. Un único 404 Not Found cubre cuatro casos que la respuesta no distingue:

  • La sesión no está en una organización que tu clave pueda leer (incluidas las sesiones de otra organización principal).
  • La sesión no existe.
  • La retención de datos cero está vigente para la sesión.
  • Todas las llamadas de la sesión han superado el período de retención.

product_surface (cadena o null) te indica de qué producto proviene la sesión. Es null si no se registró el producto. De lo contrario, es uno de estos valores:

  • cowork: Cowork en Claude Desktop en la máquina del usuario
  • claude_code: Claude Code
  • claude_science: Claude Science
  • claude_in_chrome: el chat integrado en la extensión de navegador Claude in Chrome
  • office_agents/excel, office_agents/powerpoint, office_agents/word u office_agents/outlook: Claude for Microsoft 365 en Excel, PowerPoint, Word u Outlook
  • office_agents/google_docs, office_agents/google_sheets u office_agents/google_slides: el complemento de Claude para Google Docs, Google Sheets o Google Slides
  • office_agents: Claude for Microsoft 365 o uno de los complementos de Google, cuando no se registró la aplicación

Si una sesión muestra office_agents por sí solo, no hay nada más en la respuesta que te indique de cuál de estos productos proviene. No asumas que es Claude for Microsoft 365.

El valor proviene de la actividad más reciente de la sesión, por lo que puede cambiar con el tiempo. La API comenzó a registrar los valores de Google el 5 de octubre de 2026. Una sesión de un complemento de Google cuya actividad más reciente ocurrió en esa fecha o antes puede mostrar office_agents. Si el usuario vuelve a trabajar en esa sesión, cambia al valor de Google correspondiente.

Recuperar la transcripción de una sesión local

El endpoint de mensajes devuelve la transcripción de la sesión, reconstruida a partir de las llamadas capturadas a la Claude API: prompts del usuario, texto del asistente, llamadas a herramientas y las partes de texto de los resultados de herramientas, todo devuelto tal como se envió, salvo por el truncamiento por tamaño. Nada enmascara las URL, las credenciales ni los datos personales en ese contenido, así que trata las transcripciones como información confidencial. La transcripción omite o reemplaza lo siguiente:

  • Los “thinking blocks” (bloques de pensamiento) nunca se incluyen.
  • La “system prompt” (indicación del sistema) de la solicitud nunca se devuelve. Un mensaje marcador con el texto [system prompt content not shown] la sustituye (normalmente una vez por sesión; una sesión sin contenido disponible no incluye ningún marcador).
  • Las definiciones de herramientas y la configuración de servidores MCP no forman parte de la transcripción.
  • Las imágenes, los PDF y otros bloques binarios o estructurados no se devuelven. Cada uno aparece como un bloque text con el texto [<block type> content not shown] (por ejemplo, [image content not shown]) con truncated establecido en true. Los elementos que no son de texto dentro de un resultado de herramienta, como los resultados de búsqueda web o la salida de la herramienta de ejecución de código, se reemplazan por una entrada [N non-text item(s) not shown], y el truncated del bloque de resultado de herramienta es true. La llamada a herramienta correspondiente, con la consulta de búsqueda o el código en su input, sí se devuelve.
  • Los metadatos de citas en los bloques text, como las citas de fuentes en una respuesta que se basa en resultados de búsqueda web, se omiten. El texto en sí se devuelve, y el bloque lleva truncated establecido en true.

Los archivos de instrucciones del proyecto, como CLAUDE.md, aparecen como contenido ordinario con rol de usuario. El contenido de las skills aparece cuando el cliente lo envía como contenido de mensaje y no se distingue del resto del texto del usuario. Para ver un resumen de la cobertura, consulta las preguntas frecuentes de la Compliance API; para ver una tabla que compara las sesiones locales con las sesiones remotas y el registro de OpenTelemetry, consulta la introducción de esta página.

cURL
curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/apps/sessions/local/clls_01HxKpLmNoPqRsTuVwXyZaBc/messages" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2026-10-21"
Response
{
  "session": {
    "type": "compliance_local_session",
    "id": "clls_01HxKpLmNoPqRsTuVwXyZaBc",
    "organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
    "workspace_id": "wrkspc_01SvYKoWVRVHoEbwESNvzYdR",
    "user": {
      "id": "user_01GpKpLmNoPqRsTuVwXyZaBc",
      "email_address": null
    },
    "product_surface": "cowork",
    "created_at": "2026-07-09T14:02:11Z",
    "updated_at": "2026-07-09T14:02:38Z"
  },
  "data": [
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBa",
      "role": "user",
      "model": null,
      "created_at": "2026-07-09T14:02:11Z",
      "provenance": {
        "type": "synthetic_marker"
      },
      "content": [
        {
          "type": "text",
          "text": "[system prompt content not shown]",
          "truncated": true
        }
      ]
    },
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBc",
      "role": "user",
      "model": null,
      "created_at": "2026-07-09T14:02:11Z",
      "provenance": null,
      "content": [
        {
          "type": "text",
          "text": "Fix the failing test in tests/auth_test.py",
          "truncated": false
        }
      ]
    },
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBd",
      "role": "assistant",
      "model": "claude-opus-5-5",
      "created_at": "2026-07-09T14:02:11Z",
      "provenance": null,
      "content": [
        {
          "type": "text",
          "text": "I'll read the test file first.",
          "truncated": false
        },
        {
          "type": "tool_use",
          "id": "toolu_01AbCdEfGhIjKlMnOpQrSt",
          "name": "Read",
          "input": "{\"file_path\":\"tests/auth_test.py\"}",
          "truncated": false
        }
      ]
    },
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBe",
      "role": "user",
      "model": null,
      "created_at": "2026-07-09T14:02:38Z",
      "provenance": null,
      "content": [
        {
          "type": "tool_result",
          "tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrSt",
          "name": "Read",
          "is_error": false,
          "content": [
            {
              "type": "text",
              "text": "def test_login_expiry():\n    ..."
            }
          ],
          "truncated": false
        }
      ]
    },
    {
      "type": "compliance_local_session_message",
      "id": "clsm_01J4KpLmNoPqRsTuVwXyZaBf",
      "role": "assistant",
      "model": "claude-opus-5-5",
      "created_at": "2026-07-09T14:02:38Z",
      "provenance": null,
      "content": [
        {
          "type": "text",
          "text": "The test was asserting on a stale expiry timestamp. I've updated it.",
          "truncated": false
        }
      ]
    }
  ],
  "next_page": null
}

La respuesta incluye un envoltorio session junto al arreglo paginado data. El primer registro de este ejemplo es el marcador que sustituye a la indicación del sistema de la solicitud; su provenance se describe más adelante en esta sección. En este endpoint, user.email_address siempre es null: el endpoint de mensajes no resuelve direcciones de correo electrónico, por lo que un null aquí no significa que la cuenta del usuario se haya eliminado. Para atribuir una sesión a una dirección de correo electrónico, relaciona user.id con el endpoint de lista o con el endpoint de recuperación (GET /v1/compliance/apps/sessions/local/{session_id}).

Los mensajes se devuelven del más antiguo al más reciente de forma predeterminada; pasa order=desc para invertir el orden. La paginación usa el mismo esquema page/next_page que el endpoint de lista, con un limit predeterminado de 100 y un máximo de 1,000. Una página puede terminar antes cuando la respuesta alcanza su límite de tamaño, por lo que una página con menos de limit mensajes no significa que hayas llegado al final; sigue paginando hasta que next_page sea null. Los cursores de página están vinculados a la sesión y al orden de clasificación con los que se emitieron, y los cursores de un recorrido caducan 24 horas después de su primera página: un cursor caducado devuelve 400 Bad Request indicándote que reinicies sin el parámetro page, y el recorrido reiniciado refleja el límite de retención actual. Un cursor emitido para una sesión u order diferente también devuelve 400, como cursor no válido.

En una sesión muy grande, el endpoint de mensajes puede devolver un 400 para una página, con un mensaje que indica que la página es demasiado grande para leerse; consulta Página de transcripción demasiado grande. No reintentes esa solicitud. Si usaba order=desc, lee esa sesión del más antiguo al más reciente desde su primera página, sin order y sin page, y establece el tiempo de espera de solicitud de tu cliente en al menos 5 minutos. Si una página en orden del más antiguo al más reciente devuelve el mismo error, esa entrada de la guía de errores indica qué hacer.

En una sesión muy grande, el endpoint de mensajes también podría devolver un 429 cuyo error.details.error_code es transcript_read_server_busy. No significa que tu organización haya superado un límite de velocidad. A diferencia del 400, reinténtalo: espera el número de segundos indicado en el encabezado retry-after y luego envía de nuevo la misma solicitud, sin cambios (con el mismo valor de page, si tenía uno). Consulta Servidor ocupado leyendo transcripciones grandes.

Cada mensaje incluye un role (user o assistant) y un arreglo content de bloques text, tool_use y tool_result. También incluye un model: en un turno del asistente capturado desde la Claude API, es el modelo que atendió el turno. El model es null en los mensajes de usuario y en cualquier mensaje del asistente cuyo provenance esté establecido, porque el historial afirmado por el cliente y los marcadores sintéticos no fueron producidos por un modelo, y el modelo que atendió se desconoce para el contenido no disponible. Un bloque text incluye text y truncated. Un bloque tool_use incluye id, name, input y truncated, donde input es una cadena codificada en JSON en lugar de un objeto. Un bloque tool_result incluye tool_use_id, name, is_error, un arreglo content de entradas text y truncated. Las llamadas y los resultados de herramientas MCP, y la mayoría de las llamadas y los resultados de herramientas de servidor, se normalizan en estas mismas formas tool_use y tool_result; cualquier otro tipo de bloque aparece como un marcador de posición [<block type> content not shown]. El id de un mensaje es estable mientras se retiene el turno. Todos los mensajes reconstruidos a partir de la misma llamada de inferencia llevan la marca de tiempo de esa llamada, por lo que los mensajes consecutivos suelen compartir un valor de created_at; conserva el orden devuelto en lugar de volver a ordenar por marca de tiempo.

Cada mensaje también lleva un campo provenance que describe cómo se capturó su contenido. provenance es null para el contenido verificado capturado por la Claude API, que es el caso habitual. De lo contrario, es un objeto cuyo type marca la excepción:

  • content_unavailable significa que el contenido no se puede devolver. El arreglo content está vacío y provenance.reason indica el motivo. not_captured significa que no hay contenido disponible para el turno. No demuestra que no se haya almacenado ningún registro: el contenido que las políticas de manejo de datos de Anthropic excluyen de la Compliance API se informa con el mismo motivo, al igual que los turnos individuales dentro de una sesión capturada que no están disponibles por esos motivos. Una clave administrada por el cliente inutilizable es la única excepción y devuelve 503 Service Unavailable en su lugar. client_aborted significa que el cliente cerró la conexión o canceló la solicitud antes de que se completara la respuesta, por lo que la respuesta del turno no se capturó; cualquier salida parcial ya transmitida al cliente no se incluye, y este motivo se aplica solo a los turnos con el rol de asistente. cmek_key_revoked está reservado para el contenido cifrado con la clave administrada por el cliente de tu organización cuando esa clave no está disponible (por ejemplo, revocada). Actualmente no se devuelve, porque una clave inutilizable produce un 503 en su lugar, pero contémplalo por compatibilidad futura. retention_elapsed significa que el contenido superó el período de retención. oversize significa que un único mensaje superó el límite de tamaño por mensaje; el mensaje se sigue devolviendo, con un arreglo content vacío.
  • client_asserted marca los mensajes del asistente que el cliente proporcionó como historial de la conversación y que no se pudieron asociar con una respuesta capturada; su autoría no está verificada.
  • synthetic_marker marca los registros generados por el propio endpoint, como el marcador que sustituye a la indicación del sistema. Cuando el cliente reescribe o compacta su historial de conversación a mitad de la sesión (por ejemplo, después de una compactación de contexto), la transcripción inserta un mensaje marcador en ese punto y continúa con el nuevo contenido que envió el cliente. Cuando tu organización tiene un período de retención finito y ese nuevo contenido incluye mensajes del asistente, la transcripción excluye el nuevo contenido hasta su último mensaje del asistente inclusive (un segundo marcador lo indica) y muestra solo los mensajes del usuario posteriores a ese punto, seguidos del resto de la sesión.

Los mensajes marcadores y los afirmados por el cliente comienzan con un bloque text explicativo entre corchetes marcado con truncated: true, por ejemplo [system prompt content not shown]. Trata estos registros como presentes pero no disponibles o no verificados, en lugar de ausentes, y tolera los tipos y motivos de provenance no reconocidos.

Dos parámetros limitan cuántos bytes de cada bloque de herramienta se devuelven: tool_use_input_max_bytes y tool_result_max_bytes, ambos con un valor predeterminado de 10,000 bytes. Pasa -1 para el máximo del servidor (aproximadamente 1 MiB por cadena); 0 devuelve 400 Bad Request, y los valores superiores al máximo se ajustan a él. Una cadena cortada por cualquiera de los dos límites se corta en un límite de carácter y se le añade un sufijo en banda (por ejemplo, …[truncated; pass tool_result_max_bytes=-1 for the server max]), y su bloque incluye "truncated": true. Por lo tanto, un input de tool_use truncado ya no es JSON válido, así que analiza las entradas de herramientas solo a partir de bloques no truncados (o aumenta el límite y vuelve a obtenerlos). Los bloques de tipo text siempre están limitados al mismo máximo del servidor de aproximadamente 1 MiB; ningún parámetro lo aumenta, y un bloque text que alcanza el límite también incluye "truncated": true.

Claude Science llama a los conectores (servidores MCP) desde el código que ejecuta a través de su herramienta repl, no como herramientas con nombre propio, por lo que ningún bloque de una transcripción de Claude Science lleva el nombre de un conector. Cada llamada a un conector aparece en el código dentro del input de un bloque tool_use de repl (por ejemplo, una llamada host.mcp("<server>", "<tool>", ...)), y la salida del conector aparece en el tool_result correspondiente solo donde ese código la imprimió. Las sesiones de Cowork y Claude Code son diferentes: llaman a cada herramienta de conector con su propio nombre mcp__<server>__<tool>, que es el name del bloque tool_use. Para supervisar el uso de conectores en las sesiones de Claude Science, analiza la cadena input y busca coincidencias en el código que contiene en lugar de en un nombre de herramienta. Pasa tool_use_input_max_bytes=-1 para estas sesiones, de modo que una entrada de código larga se devuelva hasta el máximo del servidor en lugar de cortarse en el valor predeterminado de 10,000 bytes antes de que aparezca la llamada al conector.

El contenido de la transcripción respeta el período de retención descrito en Sesiones en las máquinas de los usuarios. Cuando las llamadas más antiguas de una sesión lo han superado, la transcripción comienza con un único marcador de posición content_unavailable con reason igual a retention_elapsed, seguido de los mensajes retenidos. Cuando todas las llamadas de una sesión han superado la retención, el endpoint de mensajes devuelve 404 Not Found, como ocurre con las sesiones de organizaciones que tu clave no puede leer, las sesiones que no existen y las sesiones para las que está vigente la retención de datos cero. Un ID de sesión con formato incorrecto devuelve 400 Bad Request.

Sesiones en la nube (sesiones remotas)

Las sesiones de Cowork iniciadas en claude.ai web o móvil y las sesiones de Claude Tag iniciadas en Slack se ejecutan en la nube, en entornos administrados por Anthropic; las sesiones de Claude Tag también pueden ejecutarse en un grupo de runners autoalojado. La Compliance API expone estas sesiones remotas a través de dos endpoints: GET /v1/compliance/apps/sessions/remote enumera los metadatos de las sesiones, y GET /v1/compliance/apps/sessions/remote/{session_id}/messages devuelve la transcripción de una sesión. Ambos requieren el alcance read:compliance_user_data, y ambos cuentan contra el “rate limit” (límite de velocidad) compartido de la Compliance API, además de un segundo presupuesto de solicitudes específico de estos endpoints; consulta 429 Too Many Requests.

El endpoint de lista usa de forma predeterminada el alcance de toda la organización: omite organization_ids[] para incluir todas las organizaciones de claude.ai que tu clave puede leer, o pasa hasta 500 valores para acotar el alcance. Para limitar la lista a usuarios específicos, pasa de 1 a 10 valores de user_ids[] (obtén los ID en Listar usuarios de la organización); el filtro coincide con el usuario propietario de la sesión, por lo que las sesiones propiedad de agentes, incluidas las sesiones de Claude Tag propiedad de agentes, se excluyen siempre que se establezca user_ids[]. Limita los resultados en el tiempo con los parámetros de rango de created_at (gte, gt, lt, lte, en formato RFC 3339). No existe un filtro updated_at. La siguiente solicitud enumera las sesiones creadas desde una fecha determinada.

cURL
curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/sessions/remote" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2026-10-21" \
  --data-urlencode "created_at.gte=2026-06-01T00:00:00Z" \
  --data-urlencode "limit=100"
Response
{
  "data": [
    {
      "id": "cse_01WpQrStUvXyZaBcDeFgHjK6",
      "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "user": {
        "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
        "email_address": "user@example.com"
      },
      "agent_id": null,
      "started_by_user": null,
      "status": "active",
      "created_at": "2026-07-01T17:04:05Z",
      "updated_at": "2026-07-01T18:00:41Z",
      "product_surface": "cowork_remote",
      "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
    },
    {
      "id": "cse_01TkNpRsUvWxYzAbCdEfGhJ4",
      "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "user": {
        "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
        "email_address": "user@example.com"
      },
      "agent_id": null,
      "started_by_user": null,
      "status": "archived",
      "created_at": "2026-06-28T09:15:22Z",
      "updated_at": "2026-06-28T09:47:10Z",
      "product_surface": "cowork_remote",
      "claude_project_id": null
    }
  ],
  "next_page": "page_AAEfMk93cXpYdGxrZXk"
}

Los resultados se ordenan en orden cronológico inverso (los más recientes primero) por created_at y se limitan a limit resultados por respuesta (predeterminado 100, máximo 500). El endpoint pagina con tokens page y next_page (consulta Paginar resultados): pasa el valor next_page de la respuesta como el parámetro de consulta page en la siguiente solicitud, y detente cuando next_page sea null.

Una sesión es propiedad de un usuario o de un agente, nunca de ambos. En las sesiones propiedad de un usuario, user contiene el ID y la dirección de correo electrónico del propietario (email_address es null cuando el usuario ya no es miembro de una organización que tu clave puede leer) y agent_id es null. En las sesiones propiedad de un agente (por ejemplo, una sesión de Claude Tag iniciada por una mención en Slack), user es null y agent_id contiene el ID del agente (prefijo cagt_). En esas sesiones, started_by_user identifica a la persona que inició la sesión cuando se registra una, por lo que puede ser null en una sesión de Claude Tag. En las sesiones propiedad de un usuario, started_by_user es null.

Cada ejecución de una tarea programada de Cowork en la nube tiene lugar en una sesión que tiene el mismo propietario que la tarea. Cuando un usuario crea la tarea en Cowork, esas sesiones son propiedad del usuario: user identifica a ese usuario, y agent_id y started_by_user son null. Un filtro user_ids[] que incluya a ese usuario coincide con estas sesiones. Una ejecución puede iniciar una nueva sesión o continuar una existente. Cuando una ejecución continúa una sesión existente, el created_at de esa sesión es cuando comenzó la sesión, no cuando tuvo lugar la ejecución. Ningún campo de la sesión la marca como una ejecución programada ni contiene el nombre ni la programación de la tarea.

claude_project_id es el ID del proyecto de claude.ai al que pertenece la sesión (prefijo claude_proj_), o null cuando la sesión no está en un proyecto.

status es uno de pending, active, paused, archived o failed. Una sesión está en pending mientras se aprovisiona; una sesión pending aún no tiene transcripción, y el endpoint de mensajes devuelve 404 para ella hasta que se complete el aprovisionamiento. Las sesiones que se han eliminado nunca se devuelven.

product_surface (cadena o null) identifica el producto que creó la sesión. Actualmente, el endpoint devuelve sesiones con uno de dos valores de product_surface. cowork_remote corresponde a las sesiones de Cowork en la nube, incluidas las sesiones iniciadas en claude.ai web o móvil y las ejecuciones en la nube de tareas programadas de Cowork. claude_tag corresponde a las sesiones de Claude Tag iniciadas en Slack.

Para recuperar un chat en la experiencia unificada de Claude, incluida la parte que se ejecutó en la nube, usa los endpoints de chat (Obtener mensajes de chatVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver.), no los endpoints de sesiones remotas. La lista de sesiones remotas también devuelve las sesiones en las que continúa ese chat, como cowork_remote, por lo que una exportación de chats y de sesiones remotas contiene ese trabajo dos veces.

Recuperar la transcripción de una sesión remota

El endpoint de mensajes devuelve la transcripción de la sesión: las indicaciones del usuario, las respuestas del asistente y las llamadas a herramientas con sus resultados. No incluye los bloques de pensamiento ni las imágenes. Para ver un resumen de la cobertura, consulta las preguntas frecuentes de la Compliance API; para ver una tabla que compara las sesiones remotas con las sesiones locales y con el registro de OpenTelemetry de Cowork, consulta la introducción de esta página.

cURL
curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/apps/sessions/remote/cse_01WpQrStUvXyZaBcDeFgHjK6/messages" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2026-10-21"
Response
{
  "session": {
    "id": "cse_01WpQrStUvXyZaBcDeFgHjK6",
    "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
    "user": {
      "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
      "email_address": null
    },
    "agent_id": null,
    "started_by_user": null,
    "status": "active",
    "created_at": "2026-07-01T17:04:05Z",
    "updated_at": "2026-07-01T18:00:41Z",
    "product_surface": "cowork_remote",
    "claude_project_id": null
  },
  "data": [
    {
      "id": "csev_01HjKmNpQrStUvWxYzAbCdE2",
      "role": "user",
      "created_at": "2026-07-01T17:04:05Z",
      "content": [
        {
          "type": "text",
          "text": "Summarize the customer feedback in the attached spreadsheet.",
          "truncated": false
        }
      ],
      "sent_by_user_id": null,
      "content_unavailable": false
    },
    {
      "id": "csev_01BcDeFgHjKmNpQrStUvWxY4",
      "role": "assistant",
      "created_at": "2026-07-01T17:04:06Z",
      "content": [
        {
          "type": "text",
          "text": "I'll start by reading the spreadsheet...",
          "truncated": false
        }
      ],
      "sent_by_user_id": null,
      "content_unavailable": false
    }
  ],
  "next_page": null
}

La respuesta incluye un sobre session junto al arreglo paginado data. En este endpoint, el sobre siempre tiene user.email_address, started_by_user y claude_project_id establecidos en null; obtén esos valores del endpoint de lista.

De forma predeterminada, los mensajes se devuelven del más antiguo al más reciente; pasa order=desc para invertir el orden. La paginación usa el mismo esquema page/next_page que el endpoint de lista, con un limit predeterminado de 100 y un máximo de 1,000. Una página puede terminar antes de tiempo cuando la respuesta alcanza su límite de tamaño. Por eso, una página con menos de limit mensajes no significa que hayas llegado al final; sigue paginando hasta que next_page sea null.

Cada mensaje incluye un role (user o assistant) y un arreglo content de bloques text, tool_use y tool_result. Los valores created_at de los mensajes son marcas de tiempo de confirmación. Los mensajes consecutivos pueden compartir una marca de tiempo o aparecer ligeramente invertidos, así que conserva el orden devuelto en lugar de reordenar por created_at. En las sesiones propiedad de un agente, sent_by_user_id registra al usuario que envió un mensaje de usuario determinado, cuando es posible atribuirlo. En los demás casos es null, incluidos todos los mensajes del asistente. Cuando el contenido de un mensaje no se puede devolver en absoluto (por ejemplo, porque supera los límites de tamaño), el mensaje incluye content_unavailable establecido en true.

Dos parámetros limitan cuántos bytes de cada bloque de herramienta se devuelven: tool_use_input_max_bytes y tool_result_max_bytes, ambos con un valor predeterminado de 10,000 bytes. Pasa -1 para el máximo del servidor (aproximadamente 1 MiB por cada cadena); 0 devuelve 400 Bad Request. Un bloque recortado por cualquiera de los límites contiene "truncated": true, y una entrada de tool_use truncada ya no es JSON válido, así que analiza las entradas de herramientas solo a partir de bloques no truncados (o aumenta el límite y vuelve a obtenerlos).

El endpoint de mensajes devuelve 404 Not Found para sesiones pending, sesiones que no existen o que se han eliminado, y sesiones en organizaciones que tu clave no puede leer.

Retención y eliminación

Los endpoints de sesiones son de solo lectura; las sesiones locales y remotas no se pueden eliminar a través de ellos. Las transcripciones de las sesiones locales se conservan durante 6 años de forma predeterminada, o durante el período de retención de conversaciones personalizado de tu organización cuando se establece uno finito, o durante 30 días en organizaciones con la preparación para HIPAA habilitada, como se describe en Sesiones en las máquinas de los usuarios.

Las transcripciones de las sesiones remotas (como Cowork en la nube) no tienen un período de retención predeterminado. Las sesiones en la nube que Claude inicia desde un chat se eliminan junto con el chat, incluso cuando lo elimina el período de retención de conversaciones personalizado de tu organización.

Las transcripciones de las sesiones de Claude Tag tampoco tienen un período de retención predeterminado. Se eliminan cuando el canal se quita de Claude Tag, cuando el canal se elimina en Slack, cuando se desconecta el espacio de trabajo de Slack o el Enterprise Grid, y cuando se desinstala la aplicación de Slack de un espacio de trabajo. Quitar la instalación de toda la organización de un Enterprise Grid no las elimina. Exporta cualquier transcripción de Claude Tag que debas conservar antes de quitar un canal o desconectar un espacio de trabajo.

Los endpoints de sesiones remotas dejan de devolver una sesión una vez que se elimina, y su transcripción no se puede recuperar a través de la Compliance API. Para saber cómo se relaciona la retención de sesiones con los demás acuerdos de retención de Anthropic, consulta API y retención de datos.

Próximos pasos

Accede al contenido de los chats, los archivos adjuntos y los proyectos de claude.ai con la misma Compliance Access Key.

Un resumen, campo por campo, de lo que incluyen las transcripciones de sesiones, y otras preguntas comunes.

Las cargas útiles de error textuales y la solución para cada una.

Rutas de endpoints, parámetros y esquemas de respuesta de la Compliance API.

¿Te resultó útil esta página?