Manejar errores de la Compliance API

Esta página enumera los mensajes de respuesta que devuelve cada endpoint documentado de la Compliance API, la causa y la solución.

La Compliance API devuelve errores en el formato de error estándar de Anthropic: un código de estado distinto de 2xx, un encabezado de respuesta request-id y un cuerpo JSON con un objeto error que contiene type y message. Incluye el valor del encabezado request-id cuando escales el problema a soporte.

{
  "error": {
    "type": "authentication_error",
    "message": "The API key provided is invalid or has been revoked."
  }
}

Haz coincidir según error.type, no según la cadena del mensaje. Los mensajes son lo suficientemente estables como para copiarlos en runbooks, pero podrían reformularse con el tiempo; los valores de tipo forman parte del contrato de la API. Los endpoints de sesiones locales tienen algunas excepciones documentadas en las que las respuestas que comparten un tipo se distinguen por su mensaje; cada una se señala donde corresponde.

La siguiente tabla te indica de un vistazo si debes reintentar. Cada sección que sigue muestra el cuerpo del error textual y la solución.



400 Bad Request

La solicitud era sintácticamente válida pero contenía un parámetro que el servidor rechazó. Corrige el parámetro y reintenta.



Formato de marca de tiempo no válido

Tipo: invalid_request_error

The `created_at.gte` parameter contains an invalid timestamp format. Timestamps must be provided in RFC 3339 format e.g., "2024-03-01T00:00:00Z". Got "2024-01-01".

Causa: Un valor de created_at.* o updated_at.* (.gte, .gt, .lte, .lt) no pudo analizarse como datetime. El mensaje nombra el parámetro que falló y repite el valor que se envió.

Solución: Envía una marca de tiempo RFC 3339 completa que incluya hora y zona horaria, por ejemplo, 2024-03-01T00:00:00Z o 2024-03-01T00:00:00+00:00.

El listado de sesiones locales (GET /v1/compliance/apps/sessions/local) también devuelve un 400 invalid_request_error cuando se proporcionan ambos límites de tiempo y created_at.lt no es estrictamente posterior a created_at.gte. El cuerpo dice:

created_at.lt must be strictly after created_at.gte.

Envía un created_at.lt posterior a created_at.gte, u omite uno de los límites.



Límite no válido

Tipo: invalid_request_error

The limit parameter must be between 1 and 1000, inclusive. Got 1500.

Causa: El parámetro de consulta limit estaba fuera del rango aceptado. El límite nombrado en el mensaje refleja el máximo para el endpoint específico que se llamó.

Solución: Envía un limit dentro del rango que acepta el endpoint. Cada endpoint de listado tiene su propio rango de limit; consulta las restricciones de parámetros en la página correspondiente de la referencia de la Compliance API.

Los endpoints de transcripción de sesión (GET /v1/compliance/apps/sessions/remote/{session_id}/messages y GET /v1/compliance/apps/sessions/local/{session_id}/messages) validan sus parámetros de truncamiento de la misma manera: tool_use_input_max_bytes y tool_result_max_bytes aceptan cada uno un recuento de bytes positivo o -1 (el máximo del servidor), por lo que un valor como 0 devuelve el mismo 400 invalid_request_error.



ID de paginación no válido

Tipo: invalid_request_error

Invalid `after_id`. No activity found for `after_id` "activity_invalid123"

Causa: El cursor after_id o before_id no pudo decodificarse como un cursor opaco ni analizarse como un ID de actividad.

Solución: Trata los cursores de paginación como cadenas opacas. Copia siempre el valor first_id o last_id devuelto por la página anterior; detente cuando has_more sea false. No construyas cursores a partir de IDs de objetos.

Los endpoints de directorio, proyectos y sesiones (organizaciones, usuarios, roles, permisos de roles, grupos, miembros de grupos, proyectos, adjuntos de proyectos, sesiones locales y remotas, y mensajes de sesión) paginan con un token page opaco en lugar de after_id y before_id. Aplica el mismo consejo: pasa el valor next_page de la respuesta anterior sin modificar, y detente cuando has_more sea false (o, en los endpoints de sesión, que no devuelven has_more, cuando next_page sea null). Un token page mal formado devuelve el mismo 400 invalid_request_error que un after_id o before_id mal formado.

Ambos endpoints de sesiones locales (el de listado y el de mensajes) devuelven el siguiente 400 invalid_request_error para cualquier valor de page que no puedan decodificar, por ejemplo un token que fue truncado o alterado después de almacenarlo, o uno emitido por un endpoint diferente o bajo una organización principal diferente. En el endpoint de mensajes de sesión local (GET /v1/compliance/apps/sessions/local/{session_id}/messages), cada cursor page también está vinculado a la sesión y al order para los que fue emitido, por lo que un cursor emitido para una sesión o un orden de clasificación diferente devuelve el mismo cuerpo:

The page parameter is not a valid cursor for this request.

Los cursores en el endpoint de mensajes también expiran 24 horas después de que comenzó el recorrido (una pasada por las páginas). Un cursor expirado devuelve:

The page cursor has expired. Restart the walk without a page parameter; results will reflect the current retention boundary.

Para el primer cuerpo, reenvía el valor next_page sin modificar de la respuesta anterior al endpoint y la sesión que lo emitieron. Para un cursor expirado, reinicia sin un parámetro page; el nuevo recorrido refleja el límite de retención vigente cuando comienza, por lo que los mensajes que salieron del período de retención mientras tanto ya no se devuelven (consulta Recuperar una transcripción de sesión local).



401 Unauthorized

El encabezado x-api-key faltaba o no coincidía con una clave conocida. Una clave válida con los scopes incorrectos devuelve 403 Forbidden en su lugar.



Clave de API no válida

Tipo: authentication_error

The API key provided is invalid or has been revoked.

Causa: La clave en x-api-key no existe, ha sido eliminada o ha sido deshabilitada. Un encabezado x-api-key faltante o vacío devuelve el mismo cuerpo, así que revisa tanto tu almacén de secretos como el estado de revocación de la clave.

Solución: Confirma el valor de la clave, verifica que no haya sido eliminada en claude.ai (Compliance Access Keys) o en Claude Console (claves de Admin API), y confirma que esté habilitada. Consulta Configurar la Compliance API.



403 Forbidden

La clave en x-api-key es válida pero no tiene el scope que requiere el endpoint. El mensaje textual enumera los scopes que tiene la clave (Got:) y los scopes que requiere el endpoint (Needed:), para que puedas confirmar qué tiene la clave sin volver a revisar Claude Console o claude.ai. Los scopes de las Compliance Access Keys son inmutables después de su creación, por lo que cada solución de scope insuficiente te indica que crees una nueva clave en lugar de editar la existente.



Scope insuficiente: Activity Feed

Tipo: permission_error

Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['read:compliance_activities']

Causa: Se usó una clave sin read:compliance_activities para llamar a GET /v1/compliance/activities. Hay dos caminos comunes hacia este error:

• Se creó una Compliance Access Key (sk-ant-api01-...) sin el scope read:compliance_activities.
• Se creó una clave de Admin API de Claude Console (sk-ant-admin01-...) mientras la Compliance API no estaba habilitada para la organización. Las claves creadas mientras la Compliance API no estaba habilitada no tienen el scope; consulta Configurar la Compliance API.

Solución: Los scopes de las Compliance Access Keys son inmutables después de su creación. Crea una nueva clave que incluya read:compliance_activities, o usa una clave de Admin API de Claude Console. Consulta ¿Qué clave necesitas? para conocer las condiciones bajo las cuales una clave de Admin API tiene este scope.



Scope insuficiente: datos de organización

Tipo: permission_error

Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['read:compliance_org_data']

Causa: Se usó una clave sin read:compliance_org_data para llamar a un endpoint de organizaciones, roles, grupos o configuración efectiva. Hay dos caminos comunes hacia este error:

• Se creó una Compliance Access Key (sk-ant-api01-...) sin el scope read:compliance_org_data.
• Se usó una clave de Admin API de Claude Console (sk-ant-admin01-...). Las claves de Admin API solo tienen read:compliance_activities y no pueden leer metadatos de organización.

Solución: Crea una nueva Compliance Access Key con read:compliance_org_data seleccionado. Las claves de Admin API no pueden leer metadatos de organización; se requiere la Compliance Access Key.



Scope retirado: configuración de organización

Tipo: permission_error

Missing required scopes. Got: ['read:compliance_org_settings'] Needed: ['read:compliance_org_data']

Causa: El scope read:compliance_org_settings fue retirado el 30 de junio de 2026. GET /v1/compliance/organizations/{organization_id}/settings ahora requiere read:compliance_org_data, el mismo scope que los demás endpoints de organización, y el scope retirado ya no autoriza nada. Una Compliance Access Key que solo tiene read:compliance_org_settings devuelve este error en cada llamada al endpoint de configuración, aunque la clave funcionara antes del retiro. El scope retirado ya no puede seleccionarse ni otorgarse al crear una clave.

Solución: Los scopes de las Compliance Access Keys son inmutables después de su creación. Crea una nueva Compliance Access Key con read:compliance_org_data seleccionado, actualiza tu integración para usarla y luego elimina la clave antigua. Una clave que ya tiene read:compliance_org_data no se ve afectada por el retiro.



Scope insuficiente: datos de usuario

Tipo: permission_error

Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']

Causa: Se usó una clave sin read:compliance_user_data para llamar a un endpoint de chats, mensajes, archivos, proyectos, sesiones, usuarios de organización o miembros de grupo. Hay dos caminos comunes hacia este error:

• Se creó una Compliance Access Key (sk-ant-api01-...) sin el scope read:compliance_user_data.
• Se usó una clave de Admin API de Claude Console (sk-ant-admin01-...). Las claves de Admin API solo tienen read:compliance_activities y no se les puede otorgar read:compliance_user_data, por lo que no pueden llamar a los endpoints de chat, archivo, proyecto, adjunto de proyecto, sesión, usuario o miembros de grupo.

Solución: Usa una Compliance Access Key creada en claude.ai con read:compliance_user_data seleccionado. Si la solicitud realmente debería ser solo de Activity Feed, apunta la clave de Admin API a GET /v1/compliance/activities en su lugar.



Scope insuficiente: eliminación

Tipo: permission_error

Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['delete:compliance_user_data']

Causa: Se usó una Compliance Access Key sin delete:compliance_user_data para llamar a un endpoint DELETE en chats, archivos o proyectos.

Solución: Crea una nueva Compliance Access Key con delete:compliance_user_data seleccionado. El scope de eliminación es independiente de read:compliance_user_data para que las claves de auditoría de solo lectura no puedan eliminar contenido.



404 Not Found

El endpoint se resolvió pero el ID del recurso no existe o ya ha sido eliminado. Las eliminaciones de la Compliance API son inmediatas y permanentes, por lo que un 404 en un ID previamente conocido generalmente significa que el contenido fue eliminado permanentemente mediante una llamada de eliminación de la Compliance API o eliminado por una política de retención. Una excepción es una sesión remota que aún está en estado pending, cuyo endpoint de mensajes devuelve 404 de forma transitoria hasta que la sesión comienza; consulta Sesión remota no encontrada. Las cadenas de tipo de actividad citadas en cada Solución (por ejemplo, claude_chat_created) son valores que puedes pasar al filtro activity_types[] del Activity Feed; consulta Consultar actividades de cumplimiento para ver todos los valores admitidos.

Las sesiones locales no tienen estado pending, por lo que un 404 Local session not found. nunca es transitorio; consulta Sesión local no encontrada para conocer sus causas y para la respuesta separada Local sessions are not available., que no depende del ID de sesión y puede ser temporal.



Chat no encontrado

Tipo: not_found_error

Chat claude_chat_01H5CWunD7RpVJ5bHa8RCkja not found.

Causa: El ID de chat en la ruta no coincide con un chat legible a través de la Compliance API. El chat podría haber sido eliminado permanentemente mediante una llamada previa a la Compliance API o eliminado por la política de retención de tu organización, o podría pertenecer a una organización que la clave que realiza la llamada no puede leer. Los chats que un usuario eliminó de forma temporal en claude.ai no devuelven 404; siguen siendo legibles con deleted_at completado.

Solución: Confirma el ID de chat contra una actividad reciente de claude_chat_created o claude_chat_viewed. Si la actividad es reciente y la lectura sigue fallando, el chat ha sido eliminado permanentemente (a través de esta API o por expiración de la política de retención) o pertenece a una organización fuera del alcance de tu clave.



Archivo no encontrado

Tipo: not_found_error

No file found with provided id, or it has already been deleted.

Causa: El ID de archivo no existe o ha sido eliminado. Este error aplica tanto a archivos adjuntos a chats (claude_file_...) como a archivos de proyecto.

Solución: Concilia contra actividades recientes de claude_file_uploaded o claude_file_deleted. Si el archivo fue eliminado, el binario ya no existe; el registro de actividad permanece en el feed durante la ventana de retención de 6 años.



Proyecto no encontrado

Tipo: not_found_error

No project is found with the provided id.

Causa: El ID de proyecto no existe o ha sido eliminado.

Solución: Concilia contra actividades recientes de claude_project_created o claude_project_deleted. El Activity Feed continúa exponiendo los eventos del ciclo de vida del proyecto incluso después de que el proyecto en sí haya desaparecido.



Documento de proyecto no encontrado

Tipo: not_found_error

No project document found with provided id, or it has already been deleted.

Causa: El ID de documento de proyecto no existe o ha sido eliminado. Este error aplica a documentos de texto de proyecto (claude_proj_doc_...), no a archivos de proyecto.

Solución: Usa GET /v1/compliance/apps/projects/{project_id}/attachments para listar los adjuntos actuales. Si el documento falta, fue eliminado; recupéralo a través de un registro de actividad claude_project_document_uploaded si solo necesitas los metadatos.



Sesión remota no encontrada

Tipo: not_found_error

Remote session not found.

Causa: El ID de sesión pasado a GET /v1/compliance/apps/sessions/remote/{session_id}/messages no coincide con una transcripción de sesión legible a través de la Compliance API. Esto ocurre cuando el ID de sesión (cse_...) no existe o la sesión ha sido eliminada, cuando la sesión pertenece a una organización que tu clave no puede leer, o cuando el status de la sesión aún es pending: una sesión pendiente aún no tiene transcripción, por lo que el endpoint de mensajes devuelve 404 hasta que la sesión comienza. Un ID de sesión que no es un identificador cse_ bien formado devuelve 400 Bad Request en su lugar.

Solución: Confirma el ID de sesión y su status contra GET /v1/compliance/apps/sessions/remote; consulta Recuperar sesiones remotas. Si la sesión está en pending, reintenta después de que salga de ese estado. Si la sesión ya no aparece en la lista, ha sido eliminada y su transcripción no es recuperable.



Sesión local no encontrada

Tipo: not_found_error

Local session not found.

Causa: El ID de sesión pasado a GET /v1/compliance/apps/sessions/local/{session_id} o GET /v1/compliance/apps/sessions/local/{session_id}/messages no coincide con una sesión local legible a través de la Compliance API. Ambos endpoints devuelven este único mensaje, sin distinguir la causa, cuando el ID no es una sesión en una organización que tu clave puede leer (incluidos IDs que pertenecen a otra organización principal), cuando la sesión nunca existió, cuando la retención de datos cero está vigente para la sesión, o cuando toda la actividad de la sesión ha superado el período de retención que aplica a la organización que la ejecutó. A diferencia de las sesiones remotas, las sesiones locales no tienen estado pending, por lo que la respuesta Local session not found. no tiene forma transitoria. Un ID de sesión que no es un identificador clls_ bien formado devuelve 400 Bad Request en su lugar.

Los endpoints de sesiones locales, incluido el endpoint de listado, devuelven un mensaje 404 diferente, Local sessions are not available., mientras los propios endpoints no están disponibles para tu organización principal. Esa respuesta no depende del ID de sesión; ninguna clave, scope o configuración del lado del cliente la cambia, y puede ser temporal. Ambas respuestas llevan el tipo not_found_error; el texto del mensaje es lo que las distingue.

Solución: Confirma el ID de sesión contra GET /v1/compliance/apps/sessions/local; consulta Recuperar sesiones locales. Si la sesión ya no aparece en la lista, su contenido ha superado la retención (o la sesión de otro modo ya no está en una organización que tu clave puede leer) y su transcripción no es recuperable; quita el ID de tu cola. Si cada llamada, incluida la de listado, devuelve Local sessions are not available., conserva tus IDs de sesión en cola y reintenta en tu próxima ejecución programada; si la respuesta persiste, contacta a tu representante de Anthropic e incluye el encabezado de respuesta request-id.



Organización, rol o grupo no encontrado

Tipo: not_found_error

The "ce86b5f3-7c16-48b3-a9f3-e1d2c4b8a0f1" organization does not exist or the requester is not authorized to access it.

Los endpoints de organización, rol y grupo devuelven un 404 not_found_error en el formato de error estándar. El mensaje de organización nombra el org_uuid; los mensajes de rol y grupo son genéricos (Role not found., Group not found.). Esto ocurre cuando un ID de ruta (org_uuid, role_id o group_id) no existe o ya no pertenece a un árbol que la clave que realiza la llamada puede leer.

Causa: El ID en la ruta no coincide con un registro legible a través de la Compliance API. Los roles y grupos pueden eliminarse, y las organizaciones pueden desvincularse del árbol principal.

Solución: Verifica el ID contra el endpoint de listado correspondiente y concilia contra actividades recientes de organización, rol o grupo en el Activity Feed.



Configuración de organización no disponible

Tipo: not_found_error

organization `91012d09-e48b-438e-a489-1bebfd8fa6f9` not found in this organization's hierarchy

Causa: GET /v1/compliance/organizations/{organization_id}/settings devuelve este 404 en tres casos que intencionalmente comparten el mismo cuerpo para que la respuesta no revele si una organización existe: el organization_id no es una de las organizaciones vinculadas de tu organización principal, el valor no es un UUID válido, o el endpoint de configuración aún no está habilitado para tu organización principal.

Solución: Verifica el ID contra Listar organizaciones. Si un ID de organización conocido y válido aún devuelve 404, el endpoint de configuración aún no está habilitado para tu organización principal; contacta a tu representante de Anthropic.



409 Conflict

La solicitud está bien formada y autorizada pero entra en conflicto con el estado actual del recurso.



El proyecto tiene chats adjuntos

Tipo: conflict_error

The "claude_proj_01KGp4eZNug9ri4kE35RSppq" project cannot be deleted as it has chats attached to it. Delete or detach all chats, and try deleting the project again.

Causa: Se llamó a DELETE /v1/compliance/apps/projects/{project_id} en un proyecto que aún tiene chats adjuntos.

Solución: Lista los chats del proyecto con GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id} (el filtro project_ids[] requiere al menos un valor de user_ids[]; enumera los IDs a través de Listar usuarios de la organización), elimina cada uno con DELETE /v1/compliance/apps/chats/{claude_chat_id}, y luego reintenta la eliminación del proyecto.



429 Too Many Requests

Las solicitudes a la Compliance API están limitadas a 600 solicitudes por minuto por organización principal. El límite es un presupuesto compartido entre todas las claves bajo la organización principal (Compliance Access Keys y las claves de Admin API de todas las organizaciones vinculadas) y entre todos los endpoints /v1/compliance/*; los endpoints de sesiones remotas tienen un segundo presupuesto de solicitudes adicional. Para una organización independiente de Claude Console, que no tiene organización principal, el mismo presupuesto aplica a la organización misma y se comparte entre sus claves de Admin API. Contacta a tu representante de Anthropic si tu integración necesita un límite más alto.

Una vez que tu clave de API se autentica, las respuestas de la Compliance API informan el presupuesto compartido a través de los encabezados de respuesta de límite de velocidad estándar para que tu cliente pueda regular proactivamente en lugar de esperar un 429:

• anthropic-ratelimit-requests-limit es el presupuesto de solicitudes por minuto.
• anthropic-ratelimit-requests-remaining es el presupuesto restante en la ventana actual.
• anthropic-ratelimit-requests-reset es la marca de tiempo RFC 3339 cuando la ventana se reinicia y se restaura el presupuesto completo.

Una respuesta 429 también lleva un encabezado retry-after con el número de segundos que debes esperar antes de enviar la siguiente solicitud. Este valor podría incluir un pequeño margen de seguridad más allá de anthropic-ratelimit-requests-reset; respeta retry-after.

HTTP/1.1 429 Too Many Requests
date: Tue, 21 Apr 2026 14:38:02 GMT
retry-after: 25
anthropic-ratelimit-requests-limit: 600
anthropic-ratelimit-requests-remaining: 0
anthropic-ratelimit-requests-reset: 2026-04-21T14:38:25Z

{
  "error": {
    "type": "rate_limit_error",
    "message": "Compliance API rate limit of 600 requests per minute per parent organization has been exceeded. Retry after the time indicated by the retry-after header. Quote the request-id response header when contacting Anthropic support."
  }
}

Causa: Tu organización principal (u organización independiente de Claude Console) envió más de 600 solicitudes a /v1/compliance/* en una ventana de 1 minuto, entre todas las claves que comparten su presupuesto, o agotó el segundo presupuesto de solicitudes de los endpoints de sesiones remotas (descrito más adelante en esta sección).

Solución: Espera el número de segundos indicado en el encabezado retry-after, luego reintenta. Si el encabezado está ausente (por ejemplo, eliminado por un intermediario), recurre al backoff exponencial (comienza en 1 segundo, duplica hasta 60 segundos). No avances tu cursor de paginación en un 429: la solicitud fallida no devolvió datos, por lo que el cursor de la última página exitosa sigue siendo correcto.

Las solicitudes que fallan en la autenticación (una clave faltante o no reconocida, o una clave de la API de Claude en lugar de una Compliance Access Key o clave de Admin API) se rechazan antes del limitador de velocidad y no consumen cuota. Una clave válida que carece del scope requerido por el endpoint consume una unidad de cuota antes de que se devuelva el 403.

Los endpoints de sesiones remotas tienen un segundo presupuesto de solicitudes, también asociado a tu organización principal, además del límite compartido. Un 429 de ese presupuesto lleva un encabezado retry-after que siempre es 1 (una espera mínima, no el tiempo real de reinicio); cualquier encabezado anthropic-ratelimit-* en esa respuesta describe el límite compartido en lugar de este presupuesto, así que aplica backoff exponencial si el 429 se repite. Los endpoints de sesiones locales no tienen un segundo presupuesto y solo cuentan contra el límite compartido.

Si consultas el Activity Feed según un cronograma, presupuesta tu tasa agregada de solicitudes (entre todas las claves, organizaciones vinculadas y workers concurrentes) por debajo del límite compartido. Observa anthropic-ratelimit-requests-remaining para reducir la velocidad antes de alcanzarlo. Consulta Diseñar tu integración de cumplimiento para elegir entre sondeo por ventanas e ingesta basada en cursor.



500 Internal Server Error

Un 500 de la Compliance API lleva un encabezado de respuesta x-should-retry: false cuando el fallo es determinista. Los SDKs de Anthropic respetan este encabezado automáticamente. Si usas una biblioteca genérica de reintentos HTTP que reintenta en cada 5xx, suprime los reintentos cuando x-should-retry sea false; reintentar este error falla de forma idéntica en cada intento.

Un 500 sin el encabezado x-should-retry: false es transitorio: reintenta con backoff exponencial (comienza en 1 segundo, duplica hasta 60 segundos). Lo mismo aplica a las respuestas 502, 503, 504 y 529. Un 503 de sesión local, descrito a continuación, depende de los datos en lugar de ser transitorio. Consulta Errores para conocer la semántica de reintentos a nivel de plataforma.



Sesiones locales temporalmente no disponibles

Tipo: overloaded_error

The local-sessions index is temporarily unavailable. Try again shortly.

Captured content is temporarily unavailable. Try again shortly.

The local-sessions index cannot currently evaluate retention overrides for this page. Try again later.

Causa: Los endpoints de sesiones locales devuelven 503 con uno de estos cuerpos. Los dos primeros significan que los listados de sesiones, o el contenido capturado de una sesión, no están disponibles brevemente; esa es una condición transitoria relacionada con la carga o con el back end. El tercer cuerpo (que dice for this session en lugar de for this page en los endpoints de recuperación y de mensajes) significa que una configuración de retención o de manejo de datos que aplica a una o más sesiones en el rango solicitado aún no pudo evaluarse. Eso depende de los datos y la configuración de la organización que ejecutó la sesión en lugar de la carga, y puede persistir durante un período prolongado. Los tres cuerpos comparten el tipo overloaded_error, por lo que este es uno de los pocos casos en esta página donde el texto del mensaje, en lugar de error.type, distingue condiciones que necesitan un manejo diferente.

Solución: Para los dos cuerpos Try again shortly., reintenta con backoff exponencial y no avances tu cursor page, porque la solicitud fallida no devolvió datos. Para el cuerpo Try again later., no mantengas un recorrido abierto esperando a que se resuelva. En el endpoint de listado, reintenta más tarde reiniciando sin el parámetro page (un token de página de listado con más de 24 horas de antigüedad aún se acepta pero se reevalúa contra el límite de retención actual, por lo que un recorrido pausado puede omitir sesiones), o reduce la ventana de created_at.gte y created_at.lt hasta que la solicitud tenga éxito y exporta el rango omitido por separado en una ejecución posterior. En los endpoints de recuperación y de mensajes, omite ese ID de sesión, continúa con el resto de tu exportación y reintenta la sesión en una ejecución posterior; los cursores de página de mensajes expiran 24 horas después de la primera página del recorrido, así que reinicia el recorrido de esa sesión sin page cuando vuelvas a ella. Si la condición se repite en varias ejecuciones, contacta a tu representante de Anthropic e incluye el encabezado de respuesta request-id.

Para incidentes a nivel de servicio, consulta status.anthropic.com.



Próximos pasos