# MKA1: Spanish Referencia API ## Referencia API - [Spanish / Referencia API / Tools and sandbox (57 pages)](https://docs.mka1.com/_llms/es/referencia-api/tools-and-sandbox.txt): Documentation for Spanish / Referencia API / Tools and sandbox. - [Spanish / Referencia API / Usage and budgets (45 pages)](https://docs.mka1.com/_llms/es/referencia-api/usage-and-budgets.txt): Documentation for Spanish / Referencia API / Usage and budgets. ### Responses and conversations #### Responses - [Crea una respuesta impulsada por un agente con soporte de herramientas.](https://docs.mka1.com/api-reference/responses/crea-una-respuesta-impulsada-por-un-agente-con-soporte-de-herramientas.md): Crea una nueva respuesta de agente de IA utilizando modelos de lenguaje avanzados con capacidades de uso autónomo de herramientas. - [Lista todas las respuestas con paginación](https://docs.mka1.com/api-reference/responses/lista-todas-las-respuestas-con-paginación.md): Recupera una lista paginada de todas las respuestas de los agentes para el usuario autenticado. - [Recuperar respuesta por ID con estado y resultados](https://docs.mka1.com/api-reference/responses/recuperar-respuesta-por-id-con-estado-y-resultados.md): Recupera una respuesta de agente previamente creada por su ID único. Cuando stream=true, devuelve eventos enviados por el servidor para actualizaciones en tiempo real sobre respuestas en segundo plano en progreso. - [Actualizar una respuesta](https://docs.mka1.com/api-reference/responses/actualizar-una-respuesta.md): Actualiza los metadatos de una respuesta. - [Eliminar permanentemente una respuesta y sus datos](https://docs.mka1.com/api-reference/responses/eliminar-permanentemente-una-respuesta-y-sus-datos.md): Elimina permanentemente una respuesta de agente y todos los datos asociados. - [Cancelar una respuesta de fondo en progreso](https://docs.mka1.com/api-reference/responses/cancelar-una-respuesta-de-fondo-en-progreso.md): Cancela una respuesta de agente que se está procesando actualmente en segundo plano. - [Despertar una respuesta de fondo dormida](https://docs.mka1.com/api-reference/responses/despertar-una-respuesta-de-fondo-dormida.md): Interrumpe una llamada a la herramienta de sueño corto en una respuesta de fondo en progreso al proporcionar una entrada adicional. La entrega de despertar se sondea por el agente en sueño y puede tardar hasta un segundo. - [Lista de elementos de entrada paginados para una respuesta](https://docs.mka1.com/api-reference/responses/lista-de-elementos-de-entrada-paginados-para-una-respuesta.md): Recupera una lista paginada de todos los elementos de entrada proporcionados al crear la respuesta del agente especificado. - [Compactar una conversación](https://docs.mka1.com/api-reference/responses/compactar-una-conversación.md): Crea un resumen compacto del historial de la conversación para una respuesta, reduciendo el tamaño del contexto mientras preserva la información clave. Devuelve un objeto de respuesta compacto. #### Conversations - [Crear una conversación](https://docs.mka1.com/api-reference/conversations/crear-una-conversación.md): Cree una conversación para almacenar y recuperar el estado de la conversación a través de llamadas a la API de respuestas. - [Lista de conversaciones](https://docs.mka1.com/api-reference/conversations/lista-de-conversaciones.md): Enumera todas las conversaciones del usuario autenticado con soporte de paginación. - [Recuperar una conversación](https://docs.mka1.com/api-reference/conversations/recuperar-una-conversación.md): Obtén una conversación por ID. - [Actualizar una conversación](https://docs.mka1.com/api-reference/conversations/actualizar-una-conversación.md): Actualizar los metadatos de una conversación. - [Eliminar una conversación](https://docs.mka1.com/api-reference/conversations/eliminar-una-conversación.md): Eliminar una conversación. Los elementos en la conversación no se eliminarán. - [Lista de elementos de conversacion](https://docs.mka1.com/api-reference/conversations/lista-de-elementos-de-conversacion.md): Lista todos los elementos para una conversación con la ID dada. - [Crear elementos de conversación](https://docs.mka1.com/api-reference/conversations/crear-elementos-de-conversación.md): Crea elementos en una conversación con el ID dado. - [Eliminar múltiples elementos de conversación](https://docs.mka1.com/api-reference/conversations/eliminar-múltiples-elementos-de-conversación.md): Eliminar múltiples elementos de una conversación con el ID dado. - [Recuperar un elemento de conversación](https://docs.mka1.com/api-reference/conversations/recuperar-un-elemento-de-conversación.md): Obtén un único elemento de una conversación con los IDs proporcionados. - [Eliminar un elemento de conversación](https://docs.mka1.com/api-reference/conversations/eliminar-un-elemento-de-conversación.md): Eliminar un elemento de una conversación con el ID dado. ### Models and routing #### Models - [Listar modelos disponibles](https://docs.mka1.com/api-reference/models/listar-modelos-disponibles.md): Enumera los modelos actualmente disponibles. Proporciona información básica sobre cada modelo, incluyendo su ID y propietario. - [Recuperar un modelo](https://docs.mka1.com/api-reference/models/recuperar-un-modelo.md): Recupera una instancia de modelo, proporcionando información básica sobre el modelo, como el propietario y las capacidades soportadas. - [Enumera el catálogo de modelos de la organización](https://docs.mka1.com/api-reference/models/enumera-el-catálogo-de-modelos-de-la-organización.md): Enumera todas las definiciones de BYO, servicio y acceso al clúster con el estado de activación, bloqueador, estado de salud y vista previa del precio. - [Define un modelo de catálogo BYO](https://docs.mka1.com/api-reference/models/define-un-modelo-de-catálogo-byo.md): Crea una definición BYO propiedad de la API sin activar su nombre. - [Actualizar un modelo de catálogo BYO](https://docs.mka1.com/api-reference/models/actualizar-un-modelo-de-catálogo-byo.md): Actualiza una definición BYO propiedad de la API; las entradas yaml-origin son administradas por archivo e inmutables a través de esta API. - [Eliminar un modelo de catálogo BYO](https://docs.mka1.com/api-reference/models/eliminar-un-modelo-de-catálogo-byo.md): Retira una definición BYO y la desactiva solo cuando el nombre activo proviene de ese linaje BYO. - [Comprueba el estado de un modelo del catálogo BYO](https://docs.mka1.com/api-reference/models/comprueba-el-estado-de-un-modelo-del-catálogo-byo.md): Sondea una definición BYO disponible, esté o no activa. - [Enumere el acceso al modelo de clúster de una organización](https://docs.mka1.com/api-reference/models/enumere-el-acceso-al-modelo-de-clúster-de-una-organización.md): Vista del operador del clúster de las entradas disponibles del catálogo de clústeres de una organización y su estado de activación. - [Agregar acceso al modelo de clúster para una organización](https://docs.mka1.com/api-reference/models/agregar-acceso-al-modelo-de-clúster-para-una-organización.md): Agrega disponibilidad de forma idempotente sin revocar ningún nombre de modelo. Establezca activate en true para activar también cada modelo solicitado de la fuente del clúster en la organización de destino. Los permisos y las activaciones son atómicos por solicitud; un nombre activo de otra fuente… - [Reemplazar el acceso al modelo de clúster de una organización](https://docs.mka1.com/api-reference/models/reemplazar-el-acceso-al-modelo-de-clúster-de-una-organización.md): Reemplazo total serializable; los nombres de clúster activos revocados se desactivan y sus filas de precio de la organización se cierran. - [Lista de organizaciones con acceso a un modelo de clúster](https://docs.mka1.com/api-reference/models/lista-de-organizaciones-con-acceso-a-un-modelo-de-clúster.md): Búsqueda inversa del operador de clúster que muestra la disponibilidad y la activación para un id de catálogo de un clúster. - [Enumera el registro de modelos activo de la organización](https://docs.mka1.com/api-reference/models/enumera-el-registro-de-modelos-activo-de-la-organización.md): Vista única de gestión de cada nombre activo con definición cualificada por fuente, estado de salud, precio y detalles de auditoría de activación. - [Activar una entrada de catálogo](https://docs.mka1.com/api-reference/models/activar-una-entrada-de-catálogo.md): Reclama un nombre de modelo de una fuente de catálogo. La reactivación desde la misma fuente es idempotente; un titular diferente devuelve 409. - [Desactivar un nombre de registro de modelo](https://docs.mka1.com/api-reference/models/desactivar-un-nombre-de-registro-de-modelo.md): Elimina idempotentemente el nombre activo y cierra sus filas de precios en el ámbito de la organización sin tocar la definición del catálogo. - [Lista de las sobreescrituras de modelo automático de esta organización.](https://docs.mka1.com/api-reference/models/lista-de-las-sobreescrituras-de-modelo-automático-de-esta-organización.md): Devuelve cada endpoint para el cual esta organización ha establecido su propio objetivo `"auto"`. Los endpoints no listados caen en los valores predeterminados YAML del operador. - [Establecer la política automática de esta organización para un endpoint](https://docs.mka1.com/api-reference/models/establecer-la-política-automática-de-esta-organización-para-un-endpoint.md): Almacena ya sea el alias directo existente `{ endpoint → model_id }` o una política de juez con modelos candidatos. El enrutamiento por juez es compatible con respuestas, completaciones, transcripciones y TTS. Todos los modelos configurados deben estar activos al momento de escribirse; los candidato… - [Borra la anulación automática del modelo de esta organización para un endpoint.](https://docs.mka1.com/api-reference/models/borra-la-anulación-automática-del-modelo-de-esta-organización-para-un-endpoint.md): Elimina la anulación por organización para el punto final. Las solicitudes posteriores `model: "auto"` se envían nuevamente al valor predeterminado YAML del operador. - [Obtén la moneda del clúster](https://docs.mka1.com/api-reference/models/obtén-la-moneda-del-clúster.md): Devuelve el único código de moneda ISO-4217 a nivel de clúster (nulo si no está configurado). - [Configurar la moneda del clúster](https://docs.mka1.com/api-reference/models/configurar-la-moneda-del-clúster.md): Establece la moneda a nivel de clúster. Cambiarla no convierte automáticamente los precios existentes. - [Listar precios de modelos en cluster-default](https://docs.mka1.com/api-reference/models/listar-precios-de-modelos-en-cluster-default.md): Sin `model`, lista el precio actual por defecto del clúster de cada modelo. Con `model`, devuelve la historia completa fechada de ese modelo. - [Establecer un precio de modelo predeterminado para el clúster](https://docs.mka1.com/api-reference/models/establecer-un-precio-de-modelo-predeterminado-para-el-clúster.md): Actualiza el precio predeterminado del clúster para un modelo como una nueva versión datada. `rates` es un mapa de métricas→tarifas flexible; las métricas omitidas no se cobran. - [Eliminar el precio de un modelo por defecto de clúster.](https://docs.mka1.com/api-reference/models/eliminar-el-precio-de-un-modelo-por-defecto-de-clúster.md): Cierra el precio predeterminado del clúster. La línea de clúster activa entonces usa una anulación de la organización o queda sin precio ($0). - [Lista de excepciones de precios de una organización](https://docs.mka1.com/api-reference/models/lista-de-excepciones-de-precios-de-una-organización.md): Sin `model`, lista las anulaciones actuales de la organización. Con `model`, devuelve el historial de fechas de esa anulación. - [Establecer un precio de override de la organización](https://docs.mka1.com/api-reference/models/establecer-un-precio-de-override-de-la-organización.md): Inserta o actualiza un precio fechado por organización. El linaje del clúster recurre al valor predeterminado del clúster; el linaje BYO y el de servicio quedan sin precio cuando no existe ninguna fila de organización. - [Eliminar una anulación de precio de la organización](https://docs.mka1.com/api-reference/models/eliminar-una-anulación-de-precio-de-la-organización.md): Cierra un precio por organización. Solo la ascendencia de clúster activa puede entonces recurrir al valor predeterminado del clúster. - [Enumera los precios efectivos para los modelos del llamante](https://docs.mka1.com/api-reference/models/enumera-los-precios-efectivos-para-los-modelos-del-llamante.md): Para cada modelo activo, devuelve su precio teniendo en cuenta el registro: una fila de la organización, un valor predeterminado de clúster para el linaje de clúster, o sin precio ($0). También enumera el alias de enrutamiento `auto`, valorado al máximo por métrica entre todos los modelos con los qu… #### Embeddings - [Lista de modelos de embedding disponibles](https://docs.mka1.com/api-reference/embeddings/lista-de-modelos-de-embedding-disponibles.md): Devuelve una lista de modelos de incrustación disponibles con sus límites. Utiliza este punto final para descubrir qué modelos están disponibles y sus restricciones (tamaño de lote, longitud de entrada) antes de realizar solicitudes de incrustación. - [Crear incrustaciones de texto](https://docs.mka1.com/api-reference/embeddings/crear-incrustaciones-de-texto.md): Genera incrustaciones vectoriales para una o múltiples entradas de texto. Devuelve vectores de punto flotante junto con estadísticas de uso de tokens. #### Text Classification - [Clasificar texto en categorías predefinidas](https://docs.mka1.com/api-reference/text-classification/clasificar-texto-en-categorías-predefinidas.md): Clasifica el contenido del texto en una de las etiquetas predefinidas proporcionadas. ### Images and audio #### Images - [Generar imágenes a partir de descripciones de texto](https://docs.mka1.com/api-reference/images/generar-imágenes-a-partir-de-descripciones-de-texto.md): Crea imágenes generadas por IA a partir de descripciones de texto. #### Speech - [Transcripción de voz a texto](https://docs.mka1.com/api-reference/speech/transcripción-de-voz-a-texto.md): Convierte audio a texto utilizando reconocimiento de voz avanzado. - [Texto a voz](https://docs.mka1.com/api-reference/speech/texto-a-voz.md): Convierte texto a voz con detección automática de idioma. - [Transmisión de texto a voz](https://docs.mka1.com/api-reference/speech/transmisión-de-texto-a-voz.md): Convierte texto a voz con entrega de audio en streaming en tiempo real. - [Generar token de sala LiveKit](https://docs.mka1.com/api-reference/speech/generar-token-de-sala-livekit.md): Genera un token de acceso de LiveKit para unirse a una sala de voz en tiempo real. El token incluye credenciales encriptadas y configuración del modelo para el agente de voz. - [Lista del historial de texto a voz](https://docs.mka1.com/api-reference/speech/lista-del-historial-de-texto-a-voz.md): Lista las generaciones de texto a voz almacenadas para el usuario autenticado, las más recientes primero por defecto. - [Recuperar elemento del historial de texto a voz](https://docs.mka1.com/api-reference/speech/recuperar-elemento-del-historial-de-texto-a-voz.md): Devuelve metadatos para una generación de texto a voz almacenada. - [Eliminar elemento del historial de texto a voz](https://docs.mka1.com/api-reference/speech/eliminar-elemento-del-historial-de-texto-a-voz.md): Elimina una generación de texto a voz almacenada. El blob de audio está dirigido por contenido y puede ser compartido, por lo que se deja en el almacenamiento. - [Recuperar audio de texto a voz](https://docs.mka1.com/api-reference/speech/recuperar-audio-de-texto-a-voz.md): Devuelve el audio de entrada almacenado para una transcripción como respuesta binaria. - [Lista del historial de reconocimiento de voz a texto](https://docs.mka1.com/api-reference/speech/lista-del-historial-de-reconocimiento-de-voz-a-texto.md): Lista de transcripciones almacenadas para el usuario autenticado, las más recientes primero por defecto. - [Recuperar elemento del historial de voz a texto](https://docs.mka1.com/api-reference/speech/recuperar-elemento-del-historial-de-voz-a-texto.md): Devuelve los metadatos de una transcripción almacenada. - [Eliminar elemento del historial de voz a texto](https://docs.mka1.com/api-reference/speech/eliminar-elemento-del-historial-de-voz-a-texto.md): Elimina una transcripción almacenada. El blob de audio está dirigido por el contenido y puede ser compartido, por lo que se deja en almacenamiento. - [Recuperar audio de texto a voz](https://docs.mka1.com/api-reference/speech/recuperar-audio-de-texto-a-voz.md): Devuelve el audio de entrada almacenado para una transcripción como respuesta binaria. ### Files and retrieval #### Files - [Subir archivo](https://docs.mka1.com/api-reference/files/subir-archivo.md): Sube un archivo que se pueda usar con Asistentes, Almacenes Vectoriales y otras funciones. Los archivos se suben a S3 para almacenamiento duradero. - [Listar archivos](https://docs.mka1.com/api-reference/files/listar-archivos.md): Devuelve una lista de archivos que han sido subidos. - [Recuperar archivo](https://docs.mka1.com/api-reference/files/recuperar-archivo.md): Devuelve información sobre un archivo específico. - [Eliminar archivo](https://docs.mka1.com/api-reference/files/eliminar-archivo.md): Eliminar un archivo del almacenamiento. Primero se elimina el archivo de todos los almacenes vectoriales a los que esté adjunto, incluidas las incrustaciones, de modo que ya no aparezca en las búsquedas del almacén vectorial ni en los resultados de `file_search`. Si eso no puede completarse, el arch… - [Recuperar el contenido del archivo](https://docs.mka1.com/api-reference/files/recuperar-el-contenido-del-archivo.md): Devuelve el contenido binario sin procesar del archivo especificado con el encabezado Content-Type adecuado. #### Vector Stores - [Crea un almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/crea-un-almacén-de-vectores.md): Crea un nuevo almacén de vectores para almacenar y buscar a través de las representaciones de documentos. - [Lista de almacenes de vectores](https://docs.mka1.com/api-reference/vector-stores/lista-de-almacenes-de-vectores.md): Recupera una lista paginada de todas las tiendas de vectores para el usuario autenticado. - [Recuperar un almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/recuperar-un-almacén-de-vectores.md): Recupera un almacén vectorial por su ID. Devuelve 410 una vez que el almacén vectorial ha expirado. - [Modificar un almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/modificar-un-almacén-de-vectores.md): Actualiza las propiedades de un almacén vectorial existente. Devuelve 410 una vez que el almacén vectorial ha expirado. - [Eliminar un almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/eliminar-un-almacén-de-vectores.md): Elimina permanentemente un almacén de vectores y sus incrustaciones asociadas. - [Buscar un almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/buscar-un-almacén-de-vectores.md): Realiza una búsqueda semántica dentro de un almacén vectorial para encontrar los fragmentos de documento más relevantes para una consulta. Devuelve 410 una vez que el almacén vectorial ha expirado. - [Agrega un archivo a una tienda de vectores](https://docs.mka1.com/api-reference/vector-stores/agrega-un-archivo-a-una-tienda-de-vectores.md): Añade un archivo a un almacén vectorial para la indexación de búsqueda semántica. Devuelve 410 una vez que el almacén vectorial ha expirado. - [Listar archivos en un almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/listar-archivos-en-un-almacén-de-vectores.md): Recupera una lista paginada de todos los archivos en un almacén vectorial específico. Devuelve 410 una vez que el almacén vectorial ha caducado. - [Recuperar un archivo de almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/recuperar-un-archivo-de-almacén-de-vectores.md): Recupera información detallada sobre un archivo específico dentro de un almacén de vectores. Devuelve 410 una vez que el almacén de vectores ha caducado. - [Actualizar atributos del archivo](https://docs.mka1.com/api-reference/vector-stores/actualizar-atributos-del-archivo.md): Actualiza los atributos de metadatos adjuntos a un archivo dentro de un almacén vectorial. Devuelve 410 una vez que el almacén vectorial ha expirado. - [Eliminar archivo del almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/eliminar-archivo-del-almacén-de-vectores.md): Elimina un archivo de un almacén vectorial y borra sus incrustaciones asociadas. Si el archivo ya no está adjunto pero el almacén vectorial todavía conserva incrustaciones para él (por ejemplo, si quedaron de una eliminación anterior del archivo), esas incrustaciones se eliminan y la solicitud se co… - [Recuperar contenido del archivo analizado](https://docs.mka1.com/api-reference/vector-stores/recuperar-contenido-del-archivo-analizado.md): Recupera el contenido analizado completo de un archivo dentro de un almacén vectorial. Devuelve 410 una vez que el almacén vectorial ha expirado. - [Agregar por lotes varios archivos al almacén de vectores](https://docs.mka1.com/api-reference/vector-stores/agregar-por-lotes-varios-archivos-al-almacén-de-vectores.md): Agrega varios archivos a un almacén vectorial en una sola operación por lotes. Devuelve 410 una vez que el almacén vectorial ha expirado. - [Recuperar estado de lote de archivos](https://docs.mka1.com/api-reference/vector-stores/recuperar-estado-de-lote-de-archivos.md): Recupera el estado de una operación específica de lote de archivos dentro de un almacén vectorial. Devuelve 410 una vez que el almacén vectorial ha caducado. - [Cancelar el procesamiento de archivos por lotes](https://docs.mka1.com/api-reference/vector-stores/cancelar-el-procesamiento-de-archivos-por-lotes.md): Cancela una operación por lotes de archivos en curso. Devuelve 410 una vez que el almacén vectorial ha caducado. - [Listar archivos en un lote](https://docs.mka1.com/api-reference/vector-stores/listar-archivos-en-un-lote.md): Recupera una lista paginada de todos los archivos dentro de una operación de lote específica. Devuelve 410 una vez que el almacén vectorial ha expirado. ### Agents #### Agents - [Listar agentes](https://docs.mka1.com/api-reference/agents/listar-agentes.md) - [Crear un agente](https://docs.mka1.com/api-reference/agents/crear-un-agente.md) - [Recuperar un agente](https://docs.mka1.com/api-reference/agents/recuperar-un-agente.md) - [Actualizar un agente](https://docs.mka1.com/api-reference/agents/actualizar-un-agente.md) - [Eliminar un agente](https://docs.mka1.com/api-reference/agents/eliminar-un-agente.md) #### Agent Versions - [Listar versiones de agentes](https://docs.mka1.com/api-reference/agent-versions/listar-versiones-de-agentes.md): Enumera el historial de configuración de un agente. Cada cambio confirmado (crear, actualizar, deshacer) agrega una versión. - [Recuperar una versión de agente](https://docs.mka1.com/api-reference/agent-versions/recuperar-una-versión-de-agente.md) - [Retroceder un agente a una versión](https://docs.mka1.com/api-reference/agent-versions/retroceder-un-agente-a-una-versión.md): Restaura la configuración de la versión objetivo como una nueva versión actual. Se preserva el historial: la restauración se añade como una nueva versión en lugar de eliminar las versiones posteriores. #### Agent Runs - [Lista de ejecuciones para un agente](https://docs.mka1.com/api-reference/agent-runs/lista-de-ejecuciones-para-un-agente.md) - [Iniciar una ejecución de agente guardada](https://docs.mka1.com/api-reference/agent-runs/iniciar-una-ejecución-de-agente-guardada.md): Inicia una ejecución asincrónica en segundo plano para un agente guardado y devuelve el registro de ejecución en cola. Utiliza el punto de acceso de recuperación de ejecución para consultar el estado o el punto de acceso de eventos para transmitir el progreso. - [Transmitir eventos de ejecución del agente](https://docs.mka1.com/api-reference/agent-runs/transmitir-eventos-de-ejecución-del-agente.md): Transmite eventos enviados por el servidor para la respuesta del gateway vinculada a esta ejecución del agente. Las ejecuciones de terminal emiten un solo evento de terminal y se cierran. - [Despertar a un agente durmiente ejecutar](https://docs.mka1.com/api-reference/agent-runs/despertar-a-un-agente-durmiente-ejecutar.md): Interrumpe una llamada de herramienta de sueño corto en un fondo al reenvíar la entrada de seguimiento a la respuesta de la puerta de enlace. - [Aprobar o denegar una llamada pendiente a una herramienta MCP](https://docs.mka1.com/api-reference/agent-runs/aprobar-o-denegar-una-llamada-pendiente-a-una-herramienta-mcp.md): Crea una ejecución de continuación para una mcp_approval_request emitida por la ejecución de origen. La pasarela vincula la decisión de uso único al servidor, la herramienta y los argumentos originales; denegar nunca invoca la herramienta MCP remota. - [Recuperar una ejecución de agente](https://docs.mka1.com/api-reference/agent-runs/recuperar-una-ejecución-de-agente.md) #### Agent Connectors - [Lista de conectores para un agente](https://docs.mka1.com/api-reference/agent-connectors/lista-de-conectores-para-un-agente.md): Enumera los conectores de canal de mensajería configurados para el agente. Las credenciales del conector nunca se devuelven. - [Crear un conector](https://docs.mka1.com/api-reference/agent-connectors/crear-un-conector.md): Conecta el agente a un bot de Telegram o a un número de teléfono de WhatsApp Business, valida las credenciales del proveedor y registra el webhook del agente. La compatibilidad con el conector de WhatsApp está en fase beta. Los textos, fotos y documentos admitidos por la pasarela pueden invocar al a… - [Configurar un webhook de la app de WhatsApp (Beta)](https://docs.mka1.com/api-reference/agent-connectors/configurar-un-webhook-de-la-app-de-whatsapp-beta.md): Beta. Devuelve la URL de devolución de llamada a nivel de aplicación y el token de verificación que deben guardarse en Meta antes de crear el primer conector de teléfono de WhatsApp. Quien realiza la llamada debe estar autorizado para administrar el agente. El token de verificación estable se devuel… - [Recuperar un conector](https://docs.mka1.com/api-reference/agent-connectors/recuperar-un-conector.md): Recupera la configuración y el estado del conector sin exponer credenciales. - [Eliminar un conector](https://docs.mka1.com/api-reference/agent-connectors/eliminar-un-conector.md): Anula el registro del webhook del proveedor específico del conector y elimina las credenciales almacenadas del conector. Las actualizaciones pendientes de Telegram se descartan; la eliminación de WhatsApp borra solo la devolución de llamada del número de teléfono y no cancela la suscripción de otros… - [Activar un conector](https://docs.mka1.com/api-reference/agent-connectors/activar-un-conector.md): Revalida las credenciales almacenadas del proveedor y registra el webhook del proveedor. Úselo para reintentar un conector que quedó en estado de error. Se requiere autenticación con clave de API con todos los ámbitos listados; se rechaza la autenticación de sesión, y la clave debe pertenecer al usu… #### Agent Schedules - [Lista de horarios para un agente](https://docs.mka1.com/api-reference/agent-schedules/lista-de-horarios-para-un-agente.md) - [Crear un horario de agentes](https://docs.mka1.com/api-reference/agent-schedules/crear-un-horario-de-agentes.md): Crea un programa temporal respaldado de una sola vez, intervalo o cron que inicia las ejecuciones normales del agente guardadas. - [Recuperar un horario de agente](https://docs.mka1.com/api-reference/agent-schedules/recuperar-un-horario-de-agente.md) - [Actualizar un horario de agente](https://docs.mka1.com/api-reference/agent-schedules/actualizar-un-horario-de-agente.md) - [Eliminar un horario de agente](https://docs.mka1.com/api-reference/agent-schedules/eliminar-un-horario-de-agente.md) - [Pausar un horario de agente](https://docs.mka1.com/api-reference/agent-schedules/pausar-un-horario-de-agente.md) - [Reanudar el horario de un agente](https://docs.mka1.com/api-reference/agent-schedules/reanudar-el-horario-de-un-agente.md) #### Memory Stores - [Crear tienda de memoria](https://docs.mka1.com/api-reference/memory-stores/crear-tienda-de-memoria.md): Crea un almacenamiento de memoria para notas de agentes persistentes. Los almacenes son privados por defecto y se pueden compartir en todo el espacio de trabajo. - [Lista de almacenes de memoria](https://docs.mka1.com/api-reference/memory-stores/lista-de-almacenes-de-memoria.md) - [Recuperar almacenamiento de memoria](https://docs.mka1.com/api-reference/memory-stores/recuperar-almacenamiento-de-memoria.md) - [Actualizar almacenamiento de memoria](https://docs.mka1.com/api-reference/memory-stores/actualizar-almacenamiento-de-memoria.md) - [Eliminar tienda de memoria](https://docs.mka1.com/api-reference/memory-stores/eliminar-tienda-de-memoria.md) - [Crear entrada de memoria](https://docs.mka1.com/api-reference/memory-stores/crear-entrada-de-memoria.md) - [Listar entradas de memoria](https://docs.mka1.com/api-reference/memory-stores/listar-entradas-de-memoria.md) - [Recuperar entrada de memoria](https://docs.mka1.com/api-reference/memory-stores/recuperar-entrada-de-memoria.md) - [Actualizar entrada de memoria](https://docs.mka1.com/api-reference/memory-stores/actualizar-entrada-de-memoria.md) - [Eliminar entrada de memoria](https://docs.mka1.com/api-reference/memory-stores/eliminar-entrada-de-memoria.md) ### Evals and feedback #### Evals - [Crear una suite de evaluación](https://docs.mka1.com/api-reference/evals/crear-una-suite-de-evaluación.md): Crea un conjunto de evaluación declarativo específico del equipo. Los archivos del conjunto de datos y del evaluador de Python deben cargarse por separado con el propósito 'evals'. - [Listar suites de evaluación](https://docs.mka1.com/api-reference/evals/listar-suites-de-evaluación.md): Devuelve los conjuntos de evaluación visibles para el contexto del equipo autenticado. - [Obtén un conjunto de evaluación](https://docs.mka1.com/api-reference/evals/obtén-un-conjunto-de-evaluación.md): Recupera un conjunto de evaluación por ID. - [Eliminar una suite de evaluación](https://docs.mka1.com/api-reference/evals/eliminar-una-suite-de-evaluación.md): Elimina suavemente un conjunto de evaluaciones y todas sus ejecuciones de evaluación para que ya no aparezcan en lecturas visibles para el usuario. - [Crear una versión de la suite de evaluación](https://docs.mka1.com/api-reference/evals/crear-una-versión-de-la-suite-de-evaluación.md): Crea una versión inmutable de la suite. Usa este endpoint para editar una suite de evaluación existente. - [Lista de versiones de la suite de evaluación](https://docs.mka1.com/api-reference/evals/lista-de-versiones-de-la-suite-de-evaluación.md): Devuelve versiones inmutables para un conjunto de evaluación, incluyendo cada manifiesto de versión. - [Obtener una versión de la suite de evaluación](https://docs.mka1.com/api-reference/evals/obtener-una-versión-de-la-suite-de-evaluación.md): Recupera una versión inmutable del conjunto de evaluación y su manifiesto. - [Lista las ejecuciones de la clasificación para un conjunto de evaluación](https://docs.mka1.com/api-reference/evals/lista-las-ejecuciones-de-la-clasificación-para-un-conjunto-de-evaluación.md): Devuelve en una sola solicitud las ejecuciones completadas más recientes de cada grupo de clasificación para una suite, con las asignaciones de grupo en `groups`. Un grupo es (model, tarea objetivo) para ejecuciones restringidas por task_ids y (model) para ejecuciones no restringidas (task_id null).… - [Obtén la clasificación del agente de codificación para un conjunto de evaluación](https://docs.mka1.com/api-reference/evals/obtén-la-clasificación-del-agente-de-codificación-para-un-conjunto-de-evaluación.md): Clasifica las ejecuciones completadas del agente de codificación de la suite, una fila por cada (agente, modelo, esfuerzo). Solo participan las ejecuciones que registraron un `agent_name` — una ejecución de QA o de transcripción de la misma suite no tiene ningún agente al que atribuir una puntuación… - [Contar tokens del texto almacenado para las muestras no medidas de una suite](https://docs.mka1.com/api-reference/evals/contar-tokens-del-texto-almacenado-para-las-muestras-no-medidas-de-una-suite.md): Relleno para filas escritas antes de que la pasarela registrara el uso. Para muestras de las ejecuciones completadas de la suite que tienen texto de respuesta o razonamiento pero no cifra de tokens, cuenta los tokens de prompt, razonamiento y respuesta a partir del texto almacenado (tiktoken o200k_b… - [Crear una ejecución de evaluación](https://docs.mka1.com/api-reference/evals/crear-una-ejecución-de-evaluación.md): Inicia una ejecución de evaluación duradera sobre la versión de suite seleccionada, las tareas y los modelos. - [Lista de ejecuciones de evaluación](https://docs.mka1.com/api-reference/evals/lista-de-ejecuciones-de-evaluación.md): Devuelve las ejecuciones de evaluación visibles para el contexto autenticado del equipo. suite_version es un ordinal por suite y debe ir emparejado con suite_id; suministrarlo solo devuelve 400. - [Realizar una ejecución de evaluación](https://docs.mka1.com/api-reference/evals/realizar-una-ejecución-de-evaluación.md): Recupera una ejecución de evaluación por ID. - [Eliminar una ejecución de evaluación](https://docs.mka1.com/api-reference/evals/eliminar-una-ejecución-de-evaluación.md): Elimina suavemente una ejecución de evaluación para que ya no aparezca en las listas de ejecución, detalles o clasificaciones de puntuación. - [Cancelar una ejecución de evaluación](https://docs.mka1.com/api-reference/evals/cancelar-una-ejecución-de-evaluación.md): Solicita la cancelación de una evaluación en cola o en ejecución. - [Vuelve a ejecutar los ejemplos de evaluación fallidos](https://docs.mka1.com/api-reference/evals/vuelve-a-ejecutar-los-ejemplos-de-evaluación-fallidos.md): Las colas de una ejecución de evaluación completada para volver a intentar solo muestras con estado de muestra 'fallido'. Las muestras reintentadas mantienen el mismo ID de ejecución e IDs de muestra, reemplazando los resultados de muestras con errores en su lugar. - [Reintentar una ejecución de evaluación](https://docs.mka1.com/api-reference/evals/reintentar-una-ejecución-de-evaluación.md): Las colas de una evaluación fallida o cancelada se reprograman para reintentar en su lugar. Las muestras completadas conservan sus resultados, las muestras canceladas generadas pero no puntuadas se reanudan en la puntuación, las muestras inacabadas se vuelven a encolar, y las ejecuciones sin muestra… - [Obtener una descripción general de una ejecución de evaluación](https://docs.mka1.com/api-reference/evals/obtener-una-descripción-general-de-una-ejecución-de-evaluación.md): Encabezado agregado para la vista de pruebas de una ejecución: recuentos de pruebas, recompensa promedio, costo y la división de tokens de entrada/salida/caché. Su propia ruta en lugar de campos en el objeto de ejecución porque examina las muestras de la ejecución; integrarlo en `GET /evals/runs/{ru… - [Lista de muestras de evaluación](https://docs.mka1.com/api-reference/evals/lista-de-muestras-de-evaluación.md): Devuelve el aviso, el objetivo, la salida del modelo, la extracción, la puntuación y los detalles del juez para una ejecución de evaluación. - [Obtener muestra de audio de evaluación](https://docs.mka1.com/api-reference/evals/obtener-muestra-de-audio-de-evaluación.md): Devuelve `{ object, audio, sample_index, task_id, model }` para una sola muestra de transcripción — la referencia del clip (un URI `data:` en base64 o una URL) leída del `dataset_row` sin redacción (las respuestas de lista redactan blobs `data:` en línea), además de la tarea/modelo resueltos. Da pre… - [Obtener una trayectoria de muestra de evaluación](https://docs.mka1.com/api-reference/evals/obtener-una-trayectoria-de-muestra-de-evaluación.md): Devuelve la sesión de una prueba de agente de programación: los pasos que siguió el agente, literalmente en el formato de intercambio del harness (véase `schema_version`, por ejemplo, `ATIF-v1.7`). Deliberadamente no forma parte de la lista de muestras: una trayectoria promedia ~92 KB y esa lista pa… - [Sube una trayectoria de muestra de evaluación](https://docs.mka1.com/api-reference/evals/sube-una-trayectoria-de-muestra-de-evaluación.md): Almacena la sesión de una prueba de agente de codificación, en el formato de intercambio que haya producido el harness (regístralo en `schema_version`, por ejemplo `ATIF-v1.7`). `steps` se almacena literalmente y nunca se valida, por lo que un cambio en el formato del harness no necesita un lanzamie… - [Obtener artefactos de ejecución de evaluación](https://docs.mka1.com/api-reference/evals/obtener-artefactos-de-ejecución-de-evaluación.md): Devuelve los IDs de archivo de resultado generado y de artefacto de muestra para una ejecución de evaluación completada. - [Importar una ejecución finalizada de un agente de codificación](https://docs.mka1.com/api-reference/evals/importar-una-ejecución-finalizada-de-un-agente-de-codificación.md): Carga directamente un trabajo de harness completado — la ejecución y sus pruebas —, por lo que los resultados nunca hacen un ida y vuelta a través de almacenamiento externo, como hace el importador de Hugging Face. Cada `task_id` ya debe existir en el manifiesto de la versión del conjunto de destino… - [Añadir pruebas a una ejecución abierta del agente de codificación](https://docs.mka1.com/api-reference/evals/añadir-pruebas-a-una-ejecución-abierta-del-agente-de-codificación.md): Añade ensayos finalizados a una ejecución abierta con `finalize: false`, de modo que un trabajo iniciado desde MKA1 pueda supervisarse mientras se ejecuta en lugar de aparecer completo de la nada al final. Cada ensayo fija su propio `sample_index` y hace upsert sobre (task, model, sample_index): un… - [Importar resultados de evaluación históricos de Hugging Face](https://docs.mka1.com/api-reference/evals/importar-resultados-de-evaluación-históricos-de-hugging-face.md): Importa resultados de evaluación de muestras históricas en formato jsonl simplificado desde un repositorio de conjuntos de datos de Hugging Face a una estructura de ejecución de conjunto de evaluación completada. Los agregados se recomputan a partir de las muestras e incluyen métricas de puntuación… - [Crear un horario de evaluación](https://docs.mka1.com/api-reference/evals/crear-un-horario-de-evaluación.md): Programa una ejecución de evaluación para que se ejecute con una cadencia de cron o intervalo, con notificaciones opcionales por webhook sobre el estado de la ejecución. - [Listar horarios de evaluación](https://docs.mka1.com/api-reference/evals/listar-horarios-de-evaluación.md): Devuelve los horarios de evaluación visibles para el contexto del equipo autenticado. - [Obtén un horario de evaluación](https://docs.mka1.com/api-reference/evals/obtén-un-horario-de-evaluación.md): Recupera un horario de evaluación por ID, incluyendo la próxima hora de inicio programada de Temporal cuando sea resoluble. - [Actualizar un calendario de evaluaciones](https://docs.mka1.com/api-reference/evals/actualizar-un-calendario-de-evaluaciones.md): Actualiza la cadencia, la configuración de ejecución, el webhook, la política de superposición o el estado habilitado del programa de evaluación. - [Eliminar un programa de evaluación](https://docs.mka1.com/api-reference/evals/eliminar-un-programa-de-evaluación.md): Elimina suavemente un programa de evaluación y quita su programa temporal. Las ejecuciones históricas se conservan. - [Activar un programa de evaluación ahora](https://docs.mka1.com/api-reference/evals/activar-un-programa-de-evaluación-ahora.md): Dispara el horario de inmediato, además de su cadencia normal. - [Listar ejecuciones creadas por un programa de evaluación](https://docs.mka1.com/api-reference/evals/listar-ejecuciones-creadas-por-un-programa-de-evaluación.md): Devuelve las ejecuciones de evaluación creadas por el horario dado. suite_version puede usarse sin suite_id aquí, ya que el horario ya fija la suite; proporcionar un suite_id que no sea el del horario devuelve 400. #### Feedback - [Envíe comentarios para la finalización del chat](https://docs.mka1.com/api-reference/feedback/envíe-comentarios-para-la-finalización-del-chat.md): Envía comentarios de usuarios para una finalización de chat específica para rastrear la satisfacción y el rendimiento del modelo. Cada finalización solo puede recibir comentarios una vez. - [Lista de comentarios sobre la finalización del chat](https://docs.mka1.com/api-reference/feedback/lista-de-comentarios-sobre-la-finalización-del-chat.md): Recupera una lista paginada de entradas de comentarios registradas en las finalizaciones de chat del llamante, ordenadas por la fecha de creación de la finalización. Admite filtrado por calificación. Un cursor `after` que ya no resuelve a una finalización visible para el llamante devuelve 400; reini… - [Recuperar comentarios por ID de finalización](https://docs.mka1.com/api-reference/feedback/recuperar-comentarios-por-id-de-finalización.md): Recupera la calificación de retroalimentación existente y la descripción para una finalización de chat específica. - [Actualizar la retroalimentación de finalización existente](https://docs.mka1.com/api-reference/feedback/actualizar-la-retroalimentación-de-finalización-existente.md): Actualiza o modifica la retroalimentación existente para una finalización de chat específica. Útil para permitir a los usuarios revisar sus envíos iniciales. - [Recuperar feedback por lotes para múltiples finalizaciones](https://docs.mka1.com/api-reference/feedback/recuperar-feedback-por-lotes-para-múltiples-finalizaciones.md): Recupera comentarios para múltiples completaciones de chat en una sola solicitud por lotes. - [Enviar comentarios para obtener respuesta](https://docs.mka1.com/api-reference/feedback/enviar-comentarios-para-obtener-respuesta.md): Enviar comentarios de los usuarios sobre la respuesta de un agente específico para rastrear la satisfacción y el rendimiento del modelo. Cada respuesta solo puede recibir comentarios una vez. - [Lista de respuesta de comentarios](https://docs.mka1.com/api-reference/feedback/lista-de-respuesta-de-comentarios.md): Recupera una lista paginada de entradas de comentarios registradas en las respuestas del agente del llamante, ordenadas por la fecha de creación de la respuesta. Admite filtrado por valoración. Un cursor `after` que ya no resuelve a una respuesta visible para el llamante — incluidas las respuestas q… - [Recuperar feedback por ID de respuesta](https://docs.mka1.com/api-reference/feedback/recuperar-feedback-por-id-de-respuesta.md): Recupera la calificación de retroalimentación existente y la descripción para una respuesta específica del agente. - [Actualizar comentarios de respuesta existentes](https://docs.mka1.com/api-reference/feedback/actualizar-comentarios-de-respuesta-existentes.md): Actualiza o modifica la retroalimentación existente para una respuesta específica del agente. Útil para permitir a los usuarios revisar sus envíos iniciales. - [Recuperar por lotes comentarios para múltiples respuestas](https://docs.mka1.com/api-reference/feedback/recuperar-por-lotes-comentarios-para-múltiples-respuestas.md): Recupera comentarios para múltiples respuestas de agentes en una sola solicitud por lotes. - [Exportar la retroalimentación de finalización como CSV](https://docs.mka1.com/api-reference/feedback/exportar-la-retroalimentación-de-finalización-como-csv.md): Exporta sincrónicamente las entradas de comentarios de finalización visibles para el llamante como un archivo CSV, ordenadas por la fecha de creación de la solicitud subyacente. La visibilidad coincide con el endpoint de listado: los llamantes ven sus propios comentarios; los propietarios de la orga… - [Exportar comentarios de respuesta como CSV](https://docs.mka1.com/api-reference/feedback/exportar-comentarios-de-respuesta-como-csv.md): Exporta de forma síncrona las entradas de comentarios de respuesta visibles para el llamador como un archivo CSV, ordenadas por la fecha de creación de la solicitud subyacente. La visibilidad coincide con el extremo de listado: los llamadores ven sus propios comentarios; los propietarios de la organ… - [Iniciar exportación de comentarios](https://docs.mka1.com/api-reference/feedback/iniciar-exportación-de-comentarios.md): Inicia un trabajo en segundo plano para exportar todos los datos de comentarios de todos los inquilinos a archivos parquet en S3/R2. Solo puede ejecutarse una exportación simultáneamente. Restringido a los administradores del clúster. - [Obtener el estado de exportación de comentarios](https://docs.mka1.com/api-reference/feedback/obtener-el-estado-de-exportación-de-comentarios.md): Verifica el estado y el progreso del trabajo de exportación de comentarios que se está ejecutando actualmente o que se completó más recientemente. Restringido a los administradores del clúster. ### Compute #### Compute Jobs - [Lista de trabajos](https://docs.mka1.com/api-reference/compute-jobs/lista-de-trabajos.md) - [Crear un trabajo](https://docs.mka1.com/api-reference/compute-jobs/crear-un-trabajo.md) - [Consigue un trabajo](https://docs.mka1.com/api-reference/compute-jobs/consigue-un-trabajo.md) - [Lista de eventos de trabajo](https://docs.mka1.com/api-reference/compute-jobs/lista-de-eventos-de-trabajo.md) - [Listar instancias de trabajo observadas](https://docs.mka1.com/api-reference/compute-jobs/listar-instancias-de-trabajo-observadas.md) - [Lista de registros de trabajos](https://docs.mka1.com/api-reference/compute-jobs/lista-de-registros-de-trabajos.md) - [Terminar un trabajo](https://docs.mka1.com/api-reference/compute-jobs/terminar-un-trabajo.md) #### Compute Services - [Lista de servicios](https://docs.mka1.com/api-reference/compute-services/lista-de-servicios.md) - [Crear un servicio](https://docs.mka1.com/api-reference/compute-services/crear-un-servicio.md) - [Obtén un servicio](https://docs.mka1.com/api-reference/compute-services/obtén-un-servicio.md) - [Lista de eventos del servicio](https://docs.mka1.com/api-reference/compute-services/lista-de-eventos-del-servicio.md) - [Lista de instancias de servicio observadas](https://docs.mka1.com/api-reference/compute-services/lista-de-instancias-de-servicio-observadas.md) - [Lista de registros de servicio](https://docs.mka1.com/api-reference/compute-services/lista-de-registros-de-servicio.md) - [Reemplazar una política de escalado del servicio](https://docs.mka1.com/api-reference/compute-services/reemplazar-una-política-de-escalado-del-servicio.md) - [Terminar un servicio](https://docs.mka1.com/api-reference/compute-services/terminar-un-servicio.md) #### Compute Catalog - [Lista de aceleradores](https://docs.mka1.com/api-reference/compute-catalog/lista-de-aceleradores.md) - [Obtén un acelerador](https://docs.mka1.com/api-reference/compute-catalog/obtén-un-acelerador.md) - [Lista de ofertas de proveedores](https://docs.mka1.com/api-reference/compute-catalog/lista-de-ofertas-de-proveedores.md): Los administradores del clúster siempre pueden leer esta ruta. Los administradores de la organización solo pueden leerla cuando la anonimidad del proveedor está deshabilitada. - [Lista de salud del proveedor](https://docs.mka1.com/api-reference/compute-catalog/lista-de-salud-del-proveedor.md): Los administradores del clúster siempre pueden leer esta ruta. Los administradores de la organización solo pueden leerla cuando la anonimidad del proveedor está deshabilitada. - [Crear una cotización](https://docs.mka1.com/api-reference/compute-catalog/crear-una-cotización.md) #### Compute Secrets - [Lista de secretos](https://docs.mka1.com/api-reference/compute-secrets/lista-de-secretos.md) - [Crear un secreto](https://docs.mka1.com/api-reference/compute-secrets/crear-un-secreto.md) - [Eliminar un secreto](https://docs.mka1.com/api-reference/compute-secrets/eliminar-un-secreto.md) - [Obtén un secreto](https://docs.mka1.com/api-reference/compute-secrets/obtén-un-secreto.md) #### Compute Volumes - [Lista de volúmenes de organización](https://docs.mka1.com/api-reference/compute-volumes/lista-de-volúmenes-de-organización.md) - [Crear un volumen compartido independiente](https://docs.mka1.com/api-reference/compute-volumes/crear-un-volumen-compartido-independiente.md) - [Eliminar permanentemente un volumen independiente](https://docs.mka1.com/api-reference/compute-volumes/eliminar-permanentemente-un-volumen-independiente.md): La eliminación omite la habilitación del inquilino y las barreras de presupuesto, pero se rechaza mientras existan adjuntos no terminales. - [Obtener un volumen independiente](https://docs.mka1.com/api-reference/compute-volumes/obtener-un-volumen-independiente.md) - [Lista de adjuntos de volumen](https://docs.mka1.com/api-reference/compute-volumes/lista-de-adjuntos-de-volumen.md) #### Compute Usage - [Obtener uso](https://docs.mka1.com/api-reference/compute-usage/obtener-uso.md) #### Compute Tenants - [Lista de inquilinos](https://docs.mka1.com/api-reference/compute-tenants/lista-de-inquilinos.md): Solo administrador del clúster. - [Obtener un inquilino](https://docs.mka1.com/api-reference/compute-tenants/obtener-un-inquilino.md): Solo administrador del clúster. - [Actualizar un inquilino](https://docs.mka1.com/api-reference/compute-tenants/actualizar-un-inquilino.md): Upsert idempotente solo para el administrador del clúster. #### Compute Pricing - [Obtén el precio de almacenamiento comprometido más reciente](https://docs.mka1.com/api-reference/compute-pricing/obtén-el-precio-de-almacenamiento-comprometido-más-reciente.md): La última versión puede programarse para la próxima hora UTC. Antes de que se escriba la primera versión, esta ruta devuelve pricing_not_configured. - [Crear una versión inmutable del precio de almacenamiento](https://docs.mka1.com/api-reference/compute-pricing/crear-una-versión-inmutable-del-precio-de-almacenamiento.md): Solo administradores del clúster. If-Match: 0 realiza la inicialización explícita. Cada versión se activa en el siguiente límite de hora UTC; una repetición idempotente equivalente precede a la comparación de versiones. #### Tracking Experiments - [Crear](https://docs.mka1.com/api-reference/tracking-experiments/crear.md): Crea un experimento con espacio de nombres. Las ubicaciones de los artefactos son administradas por el servicio. Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [Buscar](https://docs.mka1.com/api-reference/tracking-experiments/buscar.md): Requer `read:tracking`. Os resultados são restritos à organização e à equipe da chave de API. - [Obtener](https://docs.mka1.com/api-reference/tracking-experiments/obtener.md): Requiere `read:tracking`. Los resultados están restringidos a la organización y el equipo de la clave de API. - [ObtenerPorNombre](https://docs.mka1.com/api-reference/tracking-experiments/obtenerpornombre.md): Requiere `read:tracking`. Los resultados están restringidos a la organización y el equipo de la clave de API. - [Eliminar](https://docs.mka1.com/api-reference/tracking-experiments/eliminar.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. #### Tracking Runs - [Crear](https://docs.mka1.com/api-reference/tracking-runs/crear.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [Obtener](https://docs.mka1.com/api-reference/tracking-runs/obtener.md): Requiere `read:tracking`. Los resultados están restringidos a la organización y el equipo de la clave de API. - [Buscar](https://docs.mka1.com/api-reference/tracking-runs/buscar.md): IDs de experimento explícitos são necessários; cada experimento deve pertencer ao chamador. Requer `read:tracking`. Os resultados são restritos à organização e equipe da chave de API. - [Actualización](https://docs.mka1.com/api-reference/tracking-runs/actualización.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [Eliminar](https://docs.mka1.com/api-reference/tracking-runs/eliminar.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [Restaurar](https://docs.mka1.com/api-reference/tracking-runs/restaurar.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API. - [LogMetric](https://docs.mka1.com/api-reference/tracking-runs/logmetric.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API. - [LogParameter](https://docs.mka1.com/api-reference/tracking-runs/logparameter.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [EstablecerEtiqueta](https://docs.mka1.com/api-reference/tracking-runs/estableceretiqueta.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [Eliminar etiqueta](https://docs.mka1.com/api-reference/tracking-runs/eliminar-etiqueta.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [Lote de registros](https://docs.mka1.com/api-reference/tracking-runs/lote-de-registros.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [Entradas de registro](https://docs.mka1.com/api-reference/tracking-runs/entradas-de-registro.md): Requiere `write:tracking`. Los resultados están restringidos a la organización y al equipo de la clave de API. - [ObtenerHistorialDeMétricas](https://docs.mka1.com/api-reference/tracking-runs/obtenerhistorialdemétricas.md): Requiere `read:tracking`. Los resultados están restringidos a la organización y el equipo de la clave de API. ### Repositories #### Repositories - [Enumera los repositorios de la organización de la persona que llama](https://docs.mka1.com/api-reference/repositories/enumera-los-repositorios-de-la-organización-de-la-persona-que-llama.md): Devuelve todos los repositorios de la organización del llamante (solo propietario/admin de la organización). Solo lectura. Con `kind`, solo los repositorios de ese tipo; un repositorio sin tipo (heredado, `kind: null`) aparece en el listado sin filtrar solamente. - [Crear un repositorio](https://docs.mka1.com/api-reference/repositories/crear-un-repositorio.md): Provisiona un repositorio (solo propietario/admin de la organización); una provisión fallida se revierte en la medida de lo posible (véase el `502`). El repositorio pertenece a la organización del llamador. `kind` indica qué contendrá y, por defecto, es `repo` (un repositorio git simple); decide qué… - [Eliminar un repositorio](https://docs.mka1.com/api-reference/repositories/eliminar-un-repositorio.md): Elimina un repositorio; solo el propietario o administrador de la organización. La eliminación es autorizada; el contenido se limpia con el mejor esfuerzo. - [Obtener un repositorio](https://docs.mka1.com/api-reference/repositories/obtener-un-repositorio.md): Lee un único repositorio después de la comprobación de acceso de org+rol (solo propietario/admin de la organización del repositorio). - [Actualizar las etiquetas de un repositorio](https://docs.mka1.com/api-reference/repositories/actualizar-las-etiquetas-de-un-repositorio.md): Aplica una actualización solo de la etiqueta (nombre/descripción/tipo); solo para propietario/admin de la organización. El id del repositorio es estable, así que un cambio de nombre no afecta a ningún contenido. Los campos omitidos permanecen sin cambios. #### Image tags - [Listar las etiquetas de un repositorio de imágenes](https://docs.mka1.com/api-reference/repositories/listar-las-etiquetas-de-un-repositorio-de-imágenes.md): Enumera las etiquetas de imagen de contenedor que contiene un repositorio, primero las más recientemente movidas, cada una con el manifiesto al que apunta, el tipo de medio del manifiesto, el tamaño declarado de la imagen y cuándo se movió la etiqueta por última vez. La misma comprobación de acceso… - [Eliminar una etiqueta de imagen](https://docs.mka1.com/api-reference/repositories/eliminar-una-etiqueta-de-imagen.md): Elimina una etiqueta; solo el propietario/administrador de la organización (`write:repos` para una clave). Es el mismo desetiquetado que el `DELETE /v2/{org}/{name}/manifests/{tag}` del registro: el nombre desaparece y la imagen permanece, accesible por digest y por cualquier otra etiqueta que la no… ### Dataset generations #### Generaciones - [Lista de generaciones](https://docs.mka1.com/api-reference/generations/lista-de-generaciones.md) - [Crear generación](https://docs.mka1.com/api-reference/generations/crear-generación.md): La secuencia components.md §6 D.1, en su orden: la credencial de ejecución se emite antes de que se gaste nada, no se escribe nada antes de que se fije el digest, y el flujo de trabajo comienza solo después de que la fila se ha confirmado. - [Obtener generación](https://docs.mka1.com/api-reference/generations/obtener-generación.md) - [Obtener registros](https://docs.mka1.com/api-reference/generations/obtener-registros.md) - [Obtener eventos](https://docs.mka1.com/api-reference/generations/obtener-eventos.md) - [Cancelar generación](https://docs.mka1.com/api-reference/generations/cancelar-generación.md): api.md §3: `cancelling` se escribe aquí, luego la señal; una fila `cancelling` cuya señal se perdió (el caso de reintento) se vuelve a señalar. #### Generadores - [Generadores de listas](https://docs.mka1.com/api-reference/generators/generadores-de-listas.md) - [Obtener generador](https://docs.mka1.com/api-reference/generators/obtener-generador.md) - [Generador de citas](https://docs.mka1.com/api-reference/generators/generador-de-citas.md) #### Formatos - [Formatos de Lista](https://docs.mka1.com/api-reference/formats/formatos-de-lista.md) - [Obtener formato](https://docs.mka1.com/api-reference/formats/obtener-formato.md) ### Organizations and access #### Organization - [Crear un equipo](https://docs.mka1.com/api-reference/organization/crear-un-equipo.md) - [Listar equipos en una organización](https://docs.mka1.com/api-reference/organization/listar-equipos-en-una-organización.md) - [Reúne a un equipo](https://docs.mka1.com/api-reference/organization/reúne-a-un-equipo.md) - [Renombrar un equipo](https://docs.mka1.com/api-reference/organization/renombrar-un-equipo.md) - [Eliminar un equipo](https://docs.mka1.com/api-reference/organization/eliminar-un-equipo.md) - [Añadir un miembro del equipo](https://docs.mka1.com/api-reference/organization/añadir-un-miembro-del-equipo.md): Asigna un principal (usuario o cuenta de servicio) al equipo mediante su userId. - [Listar miembros del equipo](https://docs.mka1.com/api-reference/organization/listar-miembros-del-equipo.md) - [Eliminar a un miembro del equipo](https://docs.mka1.com/api-reference/organization/eliminar-a-un-miembro-del-equipo.md) - [Crear una cuenta de servicio](https://docs.mka1.com/api-reference/organization/crear-una-cuenta-de-servicio.md): Crear un principal no humano con alcance en esta organización (solo propietario o administrador de la organización). - [Listar cuentas de servicio](https://docs.mka1.com/api-reference/organization/listar-cuentas-de-servicio.md) - [Obtener una cuenta de servicio](https://docs.mka1.com/api-reference/organization/obtener-una-cuenta-de-servicio.md) - [Eliminar una cuenta de servicio](https://docs.mka1.com/api-reference/organization/eliminar-una-cuenta-de-servicio.md) - [Enumerar las claves API de una cuenta de servicio](https://docs.mka1.com/api-reference/organization/enumerar-las-claves-api-de-una-cuenta-de-servicio.md) - [Actualizar una clave de API de cuenta de servicio](https://docs.mka1.com/api-reference/organization/actualizar-una-clave-de-api-de-cuenta-de-servicio.md) - [Eliminar una clave de API de cuenta de servicio](https://docs.mka1.com/api-reference/organization/eliminar-una-clave-de-api-de-cuenta-de-servicio.md) - [Rotar el secreto de una clave de API de una cuenta de servicio](https://docs.mka1.com/api-reference/organization/rotar-el-secreto-de-una-clave-de-api-de-una-cuenta-de-servicio.md) - [Obtener detalles básicos de la organización](https://docs.mka1.com/api-reference/organization/obtener-detalles-básicos-de-la-organización.md): Devuelve los campos básicos y el objeto de metadatos completo a un miembro de la organización o a un administrador del clúster. Nunca incluye identidades de miembros, invitaciones ni detalles de claves API. - [Organización de metadatos del parche (administrador del clúster)](https://docs.mka1.com/api-reference/organization/organización-de-metadatos-del-parche-administrador-del-clúster.md): Combina las claves de metadatos de nivel superior proporcionadas mientras preserva los elementos hermanos omitidos. metadata.codeConfig acepta una releaseManifestUrl; codeConfig:null elimina esa anulación. - [Obtener la cuota de uso de una organización](https://docs.mka1.com/api-reference/organization/obtener-la-cuota-de-uso-de-una-organización.md) - [Establecer la cuota de uso de una organización (cluster-admin)](https://docs.mka1.com/api-reference/organization/establecer-la-cuota-de-uso-de-una-organización-cluster-admin.md) - [Obtener el límite de tasa de una organización](https://docs.mka1.com/api-reference/organization/obtener-el-límite-de-tasa-de-una-organización.md) - [Establecer el límite de tasa de una organización (cluster-admin)](https://docs.mka1.com/api-reference/organization/establecer-el-límite-de-tasa-de-una-organización-cluster-admin.md) #### Cluster Admin - [Crear una invitación de clúster](https://docs.mka1.com/api-reference/cluster-admin/crear-una-invitación-de-clúster.md): Emite una invitación de un solo uso que aprovisione una nueva organización al ser aceptada. Las invitaciones vinculadas al correo electrónico pueden aceptarse sin interfaz (sin contraseña + issueApiKey). - [Lista de invitaciones al clúster](https://docs.mka1.com/api-reference/cluster-admin/lista-de-invitaciones-al-clúster.md) - [Actualizar una invitación de clúster pendiente](https://docs.mka1.com/api-reference/cluster-admin/actualizar-una-invitación-de-clúster-pendiente.md): Extender la vigencia o reemplazar de forma atómica la política de modelo disponible, cuota de API o cómputo de una invitación no reclamada y no vencida. Los campos de nivel superior omitidos se conservan. - [Revocar una invitación de clúster](https://docs.mka1.com/api-reference/cluster-admin/revocar-una-invitación-de-clúster.md) - [Lista todas las organizaciones](https://docs.mka1.com/api-reference/cluster-admin/lista-todas-las-organizaciones.md) - [Obtener una organización](https://docs.mka1.com/api-reference/cluster-admin/obtener-una-organización.md) - [Eliminar lógicamente una organización](https://docs.mka1.com/api-reference/cluster-admin/eliminar-lógicamente-una-organización.md) - [Invitar a miembros en nombre de una organización](https://docs.mka1.com/api-reference/cluster-admin/invitar-a-miembros-en-nombre-de-una-organización.md): Requiere una sesión de administrador de clúster con Cluster como organización activa. El destino debe estar activo y no puede ser Cluster. Envía hasta 20 invitaciones a organizaciones sin cambiar la sesión del administrador ni unirse a la organización de destino. Cada fila acepta el rol member o adm… - [Suspender una organización](https://docs.mka1.com/api-reference/cluster-admin/suspender-una-organización.md) - [Reactivar una organización](https://docs.mka1.com/api-reference/cluster-admin/reactivar-una-organización.md) - [Reemitir una clave de propietario de la organización (recuperación)](https://docs.mka1.com/api-reference/cluster-admin/reemitir-una-clave-de-propietario-de-la-organización-recuperación.md): Acuñe una nueva clave vinculada al propietario para una organización cuya credencial se perdió. Solo para administradores del clúster (`write:cluster`). De forma predeterminada, se usa el propietario humano más antiguo de la organización y el equipo más antiguo; `userId` / `teamId` lo reemplazan. - [Leer información de invitación al clúster (pública)](https://docs.mka1.com/api-reference/cluster-admin/leer-información-de-invitación-al-clúster-pública.md) - [Aceptar una invitación a un clúster (público)](https://docs.mka1.com/api-reference/cluster-admin/aceptar-una-invitación-a-un-clúster-público.md): Acepta una invitación y crea la organización. Un usuario ya autenticado, un nuevo propietario con correo/contraseña, o un propietario de máquina sin interfaz (vinculado por correo) con `passwordless: true, issueApiKey: true`. Un slug reservado (`api`, ya sea proporcionado como `orgSlug` o derivado d… #### Resource Authorization - [Crear un nuevo recurso](https://docs.mka1.com/api-reference/resource-authorization/crear-un-nuevo-recurso.md): Crea un recurso LLM y asigna al llamador autenticado como propietario. Los propietarios existentes pueden pasar overwrite=true para reemplazar las relaciones directas del recurso. - [Eliminar un recurso](https://docs.mka1.com/api-reference/resource-authorization/eliminar-un-recurso.md): Elimina un recurso de LLM y todos sus permisos directos. Solo los propietarios pueden eliminar recursos. - [Otorgar permiso a un usuario o hacerlo público](https://docs.mka1.com/api-reference/resource-authorization/otorgar-permiso-a-un-usuario-o-hacerlo-público.md): Otorga un rol a un usuario para un recurso de git, o concede acceso público usando "*" como userId. Solo los propietarios pueden conceder permisos. El acceso público solo se permite para los roles de writer y reader. - [Revocar permiso a un usuario o eliminar el acceso público](https://docs.mka1.com/api-reference/resource-authorization/revocar-permiso-a-un-usuario-o-eliminar-el-acceso-público.md): Revoca un rol de un usuario para un recurso de git, o elimina el acceso público usando "*" como userId. Solo los propietarios pueden revocar permisos. - [Lista de recursos a los que el usuario tiene acceso.](https://docs.mka1.com/api-reference/resource-authorization/lista-de-recursos-a-los-que-el-usuario-tiene-acceso.md): Enumera los recursos de un tipo específico donde el llamado autenticado tiene el rol especificado. Devuelve solo relaciones directas (no calculadas). - [Listar usuarios con permisos](https://docs.mka1.com/api-reference/resource-authorization/listar-usuarios-con-permisos.md): Lista los usuarios con un rol específico en un recurso. Devuelve solo relaciones directas (no computadas). El llamador autenticado debe tener al menos acceso de lector. - [Verificar permisos de usuario](https://docs.mka1.com/api-reference/resource-authorization/verificar-permisos-de-usuario.md): Verifica si el llamador autenticado tiene un rol específico sobre un recurso. - [Crear un nuevo recurso de git](https://docs.mka1.com/api-reference/resource-authorization/crear-un-nuevo-recurso-de-git.md): Cree un recurso git y asigne al llamador autenticado como propietario. Los propietarios existentes pueden pasar overwrite=true para reemplazar las relaciones directas del recurso. - [Eliminar un recurso de git](https://docs.mka1.com/api-reference/resource-authorization/eliminar-un-recurso-de-git.md): Eliminar un recurso de git y todos sus permisos directos. Solo los propietarios pueden eliminar recursos. - [Otorgar permiso a un usuario o hacerlo público](https://docs.mka1.com/api-reference/resource-authorization/otorgar-permiso-a-un-usuario-o-hacerlo-público.md): Otorga un rol a un usuario para un recurso de git, o concede acceso público usando "*" como userId. Solo los propietarios pueden conceder permisos. El acceso público solo se permite para los roles de writer y reader. - [Revocar permiso a un usuario o eliminar el acceso público](https://docs.mka1.com/api-reference/resource-authorization/revocar-permiso-a-un-usuario-o-eliminar-el-acceso-público.md): Revoca un rol de un usuario para un recurso de git, o elimina el acceso público usando "*" como userId. Solo los propietarios pueden revocar permisos. - [Verificar un permiso explícito del sujeto](https://docs.mka1.com/api-reference/resource-authorization/verificar-un-permiso-explícito-del-sujeto.md): Comprueba si un sujeto específico (indicado en el cuerpo) tiene un rol en un recurso de git. Utilizado por el proxy de autorización para hacer cumplir el acceso para el usuario de git en cuyo nombre actúa. El llamante autenticado debe tener el ámbito de autorización de lectura; el sujeto es independ… #### API Key - [Crear una clave de API con alcance محدود](https://docs.mka1.com/api-reference/api-key/crear-una-clave-de-api-con-alcance-محدود.md): Acuña una clave API vinculada a un (principal, equipo) que lleve un conjunto de ámbitos explícito. Requiere una sesión, o una clave portadora que tenga `write:apikeys`. El secreto en texto plano se devuelve una sola vez. - [Lista de claves de API con ámbito limitado](https://docs.mka1.com/api-reference/api-key/lista-de-claves-de-api-con-ámbito-limitado.md): Enumera las claves de API con ámbito del llamante (solo metadatos — nunca el secreto). Opcionalmente, `?orgId=&teamId=` restringe; una clave a la que el llamante está asignado está limitada a su propia organización. - [Actualizar una clave de API restringida](https://docs.mka1.com/api-reference/api-key/actualizar-una-clave-de-api-restringida.md): Actualizar los ámbitos de una clave (y opcionalmente el nombre / límite de tasa). Los ámbitos que ya están en la clave se conservan; los ámbitos recién añadidos están limitados por el rol del llamador (y, para un llamador de clave, por los propios ámbitos de la clave que llama). - [Rotar el secreto de una clave API con ámbito limitado](https://docs.mka1.com/api-reference/api-key/rotar-el-secreto-de-una-clave-api-con-ámbito-limitado.md): Emita un nuevo secreto en texto plano para una clave existente en su lugar (id / scopes / binding preservados). Devuelto una sola vez. - [Intercambiar la clave API por un token JWT](https://docs.mka1.com/api-reference/api-key/intercambiar-la-clave-api-por-un-token-jwt.md): Intercambiar una clave API por un token JWT - [Intercambiar la clave API por un token JWT](https://docs.mka1.com/api-reference/api-key/intercambiar-la-clave-api-por-un-token-jwt.md): Intercambiar una clave API por un token JWT #### Session - [Encuentra una invitación inacabada para el destinatario que ha iniciado sesión](https://docs.mka1.com/api-reference/session/encuentra-una-invitación-inacabada-para-el-destinatario-que-ha-iniciado-sesión.md): Requiere una sesión con un correo electrónico verificado. Devuelve primero una invitación de organización pendiente y no caducada; de lo contrario, una invitación de clúster no reclamada y no caducada vinculada a ese correo electrónico. Las invitaciones abiertas de clúster nunca se devuelven. No ace… - [Intercambiar una sesión activa por un token de acceso delegado](https://docs.mka1.com/api-reference/session/intercambiar-una-sesión-activa-por-un-token-de-acceso-delegado.md): Acuña un token de corta duración, vinculado a la audiencia, con la misma autoridad que la sesión activa actual del navegador o de inicio de sesión en el dispositivo. La identidad, la tenencia, los permisos y la duración no pueden ser seleccionados por el llamador. El cuerpo JSON está limitado a 4 Ki… ### Application utilities #### Batches - [Crear un lote](https://docs.mka1.com/api-reference/batches/crear-un-lote.md): Crea y ejecuta un lote a partir de un archivo JSONL de solicitudes cargado. Cada línea debe tener los campos custom_id, method, url y body. Los lotes de texto también requieren write:responses. - [Listar lotes](https://docs.mka1.com/api-reference/batches/listar-lotes.md): Retorna uma lista paginada de lotes pertencentes ao usuário autenticado. - [Obtener un lote](https://docs.mka1.com/api-reference/batches/obtener-un-lote.md): Recupera un lote por su ID. - [Cancelar un lote](https://docs.mka1.com/api-reference/batches/cancelar-un-lote.md): Cancela un lote en progreso. El estado del lote cambia a cancelando, y las solicitudes restantes no serán procesadas. #### Extract - [Extraer datos estructurados con esquema JSON en línea](https://docs.mka1.com/api-reference/extract/extraer-datos-estructurados-con-esquema-json-en-línea.md): Extrae datos estructurados de archivos utilizando un esquema JSON en línea personalizado. - [Crear plantilla de esquema de extracción reutilizable](https://docs.mka1.com/api-reference/extract/crear-plantilla-de-esquema-de-extracción-reutilizable.md): Crea y almacena una plantilla de esquema JSON reutilizable para la extracción de datos estructurados. - [Obtener esquema de extracción por ID](https://docs.mka1.com/api-reference/extract/obtener-esquema-de-extracción-por-id.md): Recuperar un esquema de extracción almacenado y su metadata. - [Actualizar esquema de extracción por ID](https://docs.mka1.com/api-reference/extract/actualizar-esquema-de-extracción-por-id.md): Actualizar un esquema de extracción existente y sus metadatos. - [Eliminar esquema de extracción por ID](https://docs.mka1.com/api-reference/extract/eliminar-esquema-de-extracción-por-id.md): Eliminar un esquema de extracción almacenado. - [Extraer datos utilizando plantilla de esquema guardada](https://docs.mka1.com/api-reference/extract/extraer-datos-utilizando-plantilla-de-esquema-guardada.md): Extrae datos estructurados de archivos utilizando una plantilla de esquema de extracción guardada previamente. #### Guardrails - [Consigue barreras de seguridad efectivas](https://docs.mka1.com/api-reference/guardrails/consigue-barreras-de-seguridad-efectivas.md): Recupera las directrices que se aplican a las solicitudes del llamante: la política de toda la organización más la política del equipo del llamante, combinadas. Ambas se aplican cuando ambas existen. Las políticas son gestionadas por los administradores de la organización mediante PUT /guardrails. - [Actualizar la política de barreras de protección](https://docs.mka1.com/api-reference/guardrails/actualizar-la-política-de-barreras-de-protección.md): Reemplace una política de guardrails. Los modelos clasificadores deben estar activos y declarar compatibilidad con salida estructurada; reemplace el ID del modelo de ejemplo por un modelo adecuado de su organización. Omita team_id para establecer la política a nivel de organización (solo administrad… - [Eliminar la política de barandillas](https://docs.mka1.com/api-reference/guardrails/eliminar-la-política-de-barandillas.md): Eliminar una política de guardrails. Omita team_id para eliminar la política de toda la organización (solo administrador de la organización); proporcione team_id para eliminar la política de ese equipo (los administradores de la organización pueden dirigirse a cualquier equipo de su organización, ot… - [Lista de políticas de barandillas](https://docs.mka1.com/api-reference/guardrails/lista-de-políticas-de-barandillas.md): Enumera las políticas de guardrails almacenadas visibles para el llamante: los administradores de la organización ven todas las políticas de su organización (la política de toda la organización tiene team_id null, además de la política adicional de cada equipo); los demás llamantes ven la política d… - [Contenido de prueba contra barandas](https://docs.mka1.com/api-reference/guardrails/contenido-de-prueba-contra-barandas.md): Prueba una pieza de contenido contra las guardrails efectivas de quien llama (la política de toda la organización más la política del equipo) sin generar una respuesta. Las guardrails del clasificador llaman a su modelo configurado e incurren en uso de inferencia; las claves de API además requieren… #### Prompts - [Crea un aviso](https://docs.mka1.com/api-reference/prompts/crea-un-aviso.md): Crea un nuevo aviso con su primera versión. La plantilla admite marcadores de posición {{variable}}. - [Lista de indicaciones](https://docs.mka1.com/api-reference/prompts/lista-de-indicaciones.md): Devuelve una lista paginada de mensajes propiedad del usuario autenticado. - [Obtén un aviso](https://docs.mka1.com/api-reference/prompts/obtén-un-aviso.md): Recupera un aviso por su ID, incluyendo la plantilla activa. Pasa `version` para obtener la plantilla de una versión específica. Pasa `variables` como un mapa codificado en JSON para renderizar la plantilla con sustituciones. - [Actualizar un aviso](https://docs.mka1.com/api-reference/prompts/actualizar-un-aviso.md): Las actualizaciones modifican los metadatos. Para actualizar el contenido de la plantilla, crea una nueva versión en su lugar. - [Eliminar un aviso](https://docs.mka1.com/api-reference/prompts/eliminar-un-aviso.md): Elimina un aviso y todas sus versiones. - [Crear una nueva versión](https://docs.mka1.com/api-reference/prompts/crear-una-nueva-versión.md): Crea una nueva versión de un aviso. La nueva versión se convierte automáticamente en la versión activa. Los campos no proporcionados se trasladan de la versión anterior. - [Listar versiones](https://docs.mka1.com/api-reference/prompts/listar-versiones.md): Devuelve el historial de versiones de un aviso, ordenado por número de versión. - [Obtener una versión específica](https://docs.mka1.com/api-reference/prompts/obtener-una-versión-específica.md): Recupera una versión específica de un aviso por número de versión. - [Revertir a una versión](https://docs.mka1.com/api-reference/prompts/revertir-a-una-versión.md): Establece la versión activa de un aviso a una versión anterior. Esto no elimina versiones más nuevas; solo cambia qué versión está activa. ### Analytics #### Proyectos - [Create a project](https://docs.mka1.com/api-reference/analyticsprojects/crear-un-proyecto-de-análisis.md): Crea un proyecto en la organización del llamador. Sin team_id, el proyecto pertenece al equipo autenticado. Los propietarios y administradores de la organización pueden crear un proyecto para cualquier equipo de su organización, incluidos equipos de los que no sean miembros, o pasar team_id: null pa… - [List projects](https://docs.mka1.com/api-reference/analyticsprojects/listar-proyectos-de-análisis-accesibles.md): Los propietarios y administradores de la organización ven todos los proyectos de su organización: todos los proyectos de los equipos y los proyectos a nivel de organización, independientemente de su equipo activo. Esto también se aplica a las claves API y a los JWT intercambiados de un propietario o… - [Get a project](https://docs.mka1.com/api-reference/analyticsprojects/obtener-un-proyecto-de-analíticas.md) - [Update a project](https://docs.mka1.com/api-reference/analyticsprojects/renombrar-un-proyecto-de-análisis-activo.md): Renombra un proyecto activo. La propiedad del proyecto no se puede cambiar. - [Archive a project](https://docs.mka1.com/api-reference/analyticsprojects/archivar-un-proyecto-de-análisis.md): Detener nuevas capturas y consultas para este proyecto. Los eventos previamente aceptados continúan procesándose. El archivado no elimina los eventos almacenados. #### Claves de captura - [Create a capture key](https://docs.mka1.com/api-reference/analyticskeys/crea-una-clave-de-captura-y-devuelve-su-secreto-una-sola-vez.md): Crea una clave que pueda enviar eventos a este proyecto. Guarda la clave de esta respuesta; su secreto solo se devuelve una vez. Las claves de captura no pueden leer análisis ni administrar proyectos. - [List capture keys](https://docs.mka1.com/api-reference/analyticskeys/capturar-lista-de-metadatos-clave.md) - [Revoke a capture key](https://docs.mka1.com/api-reference/analyticskeys/revocar-una-clave-de-captura.md) #### Eventos - [Capture events](https://docs.mka1.com/api-reference/analytics/aceptar-de-forma-duradera-un-lote-de-eventos.md): Envía un lote de eventos utilizando el encabezado X-Analytics-Key del proyecto. Una respuesta 202 confirma que el lote se ha almacenado; los eventos estarán disponibles para las consultas después del procesamiento en segundo plano. Vuelve a intentarlo con la misma idempotency_key y sin cambios en lo… - [Query events](https://docs.mka1.com/api-reference/analytics/consultar-recuentos-de-eventos-o-visitantes-únicos.md): Cuenta eventos o visitantes únicos en un intervalo de tiempo. Opcionalmente, filtra por nombre de evento o propiedades, agrupa por una propiedad y divide los resultados en intervalos de hora, día o semana que comienzan en el reloj de una zona horaria IANA, UTC de forma predeterminada. Cada intervalo… #### Búsqueda de eventos - [Search events](https://docs.mka1.com/api-reference/analyticsevents/buscar-eventos-en-un-intervalo-de-tiempo.md): Enumera los eventos individuales en un intervalo de tiempo, primero los más recientes, con sus propiedades. Opcionalmente filtra por nombre del evento, propiedades del evento o el distinct_id de un visitante. El intervalo incluye el valor de inicio y excluye el de fin, y los IDs de eventos duplicado… #### Búsqueda de visitantes - [Search visitors](https://docs.mka1.com/api-reference/analyticsvisitors/buscar-visitantes-en-un-rango-de-tiempo.md): Enumera los visitantes con eventos coincidentes en un rango de tiempo, mostrando primero los más recientemente activos. Cada visitante es un distinct_id con las marcas de tiempo de su primer y último evento coincidente y su recuento de eventos en todo el rango; por lo tanto, para un rango que no rec… ### Legacy APIs #### Chat Completions - [[Obsoleto] Completaciones de chat para el uso del SDK/client de OpenAI](https://docs.mka1.com/api-reference/chat-completions/[obsoleto]-completaciones-de-chat-para-el-uso-del-sdkclient-de-openai.md): **Obsoleto: Utilice la API de Respuestas (`/api/v1/llm/responses`) en su lugar.** Punto de terminación de completación de chat compatible con OpenAI, diseñado para usarse con las bibliotecas de cliente oficiales de OpenAI (Python, Node.js, etc.). Soporta tanto solicitudes en streaming como no stream… - [[Obsoleto] Compleciones de chat en streaming para el uso del SDK generado](https://docs.mka1.com/api-reference/chat-completions/[obsoleto]-compleciones-de-chat-en-streaming-para-el-uso-del-sdk-generado.md): **Obsoleto: Utiliza la API de Respuestas (`/api/v1/llm/responses`) en su lugar.** Punto final de finalización de chat en streaming diseñado para su uso con el SDK de TypeScript/JavaScript generado a partir de la especificación de OpenAPI. Este punto final utiliza el streaming nativo de ORPC a través… #### Fine-Tuning - [[Obsoleto] Crear un trabajo de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-crear-un-trabajo-de-ajuste-fino.md): **En desuso: use los trabajos de cómputo (`/api/v1/compute/jobs`) en su lugar.** Crea un trabajo de ajuste fino que inicia el proceso de entrenamiento de un nuevo modelo a partir de un conjunto de datos dado. - [[Obsoleto] Lista de trabajos de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-lista-de-trabajos-de-ajuste-fino.md): **Obsoleto: use trabajos de cómputo (`/api/v1/compute/jobs`) en su lugar.** Enumere los trabajos de ajuste fino de su organización. - [[Obsoleto] Recuperar un trabajo de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-recuperar-un-trabajo-de-ajuste-fino.md): **Obsoleto: use trabajos de computación (`/api/v1/compute/jobs`) en su lugar.** Obtenga información sobre un trabajo de ajuste fino. - [[Obsoleto] Cancelar un trabajo de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-cancelar-un-trabajo-de-ajuste-fino.md): **Obsoleto: usa los trabajos de Compute (`/api/v1/compute/jobs`) en su lugar.** Cancela inmediatamente un trabajo de ajuste fino. - [[Obsoleto] Pausar un trabajo de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-pausar-un-trabajo-de-ajuste-fino.md): **Obsoleto: use trabajos de cómputo (`/api/v1/compute/jobs`) en su lugar.** Pausa un trabajo de ajuste fino en ejecución. - [[Obsoleto] Reanudar un trabajo de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-reanudar-un-trabajo-de-ajuste-fino.md): **Obsoleto: Use trabajos de cómputo (`/api/v1/compute/jobs`) en su lugar.** Reanuda un trabajo de ajuste fino en pausa. - [[Obsoleto] Lista de eventos de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-lista-de-eventos-de-ajuste-fino.md): **Obsoleto: use trabajos de Compute (`/api/v1/compute/jobs`) en su lugar.** Obtenga actualizaciones de estado para un trabajo de ajuste fino. - [[Obsoleto] Lista de puntos de control de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-lista-de-puntos-de-control-de-ajuste-fino.md): **Obsoleto: use trabajos de cómputo (`/api/v1/compute/jobs`) en su lugar.** Listar puntos de control para un trabajo de ajuste fino. ### Additional APIs #### Billing - [Get apiv1budgetingbillingorg](https://docs.mka1.com/api-reference/billing/get-apiv1budgetingbillingorg.md) - [Put apiv1budgetingbillingorgenabled](https://docs.mka1.com/api-reference/billing/put-apiv1budgetingbillingorgenabled.md) - [Put apiv1budgetingbillingorgprofile](https://docs.mka1.com/api-reference/billing/put-apiv1budgetingbillingorgprofile.md) - [Post apiv1budgetingbillingorgsetup session](https://docs.mka1.com/api-reference/billing/post-apiv1budgetingbillingorgsetup-session.md) - [Post apiv1budgetingbillingorgportal session](https://docs.mka1.com/api-reference/billing/post-apiv1budgetingbillingorgportal-session.md) - [Get apiv1budgetingbillingorginvoices](https://docs.mka1.com/api-reference/billing/get-apiv1budgetingbillingorginvoices.md) #### Feature Flags - [Lista de banderas](https://docs.mka1.com/api-reference/feature-flags/lista-de-banderas.md): Cada bandera con un resumen de su estado por entorno. - [Crear una bandera](https://docs.mka1.com/api-reference/feature-flags/crear-una-bandera.md): La bandera comienza deshabilitada en todos los entornos y pertenece a Default cuando se omite project_id. - [Lista de proyectos](https://docs.mka1.com/api-reference/feature-flags/lista-de-proyectos.md) - [Crear un proyecto](https://docs.mka1.com/api-reference/feature-flags/crear-un-proyecto.md) - [Eliminar un proyecto vacío](https://docs.mka1.com/api-reference/feature-flags/eliminar-un-proyecto-vacío.md): El predeterminado no se puede eliminar. Mueve o elimina cada bandera antes de eliminar otro proyecto. - [Obtener un proyecto](https://docs.mka1.com/api-reference/feature-flags/obtener-un-proyecto.md) - [Renombrar un proyecto](https://docs.mka1.com/api-reference/feature-flags/renombrar-un-proyecto.md) - [Lista de entradas de auditoría, primero las más recientes](https://docs.mka1.com/api-reference/feature-flags/lista-de-entradas-de-auditoría-primero-las-más-recientes.md) - [Lista de entornos](https://docs.mka1.com/api-reference/feature-flags/lista-de-entornos.md) - [Crear un entorno](https://docs.mka1.com/api-reference/feature-flags/crear-un-entorno.md): Cada bandera existente obtiene un estado deshabilitado en el nuevo entorno. - [Eliminar un entorno y todos los ajustes de banderas en él](https://docs.mka1.com/api-reference/feature-flags/eliminar-un-entorno-y-todos-los-ajustes-de-banderas-en-él.md) - [Renombrar un entorno](https://docs.mka1.com/api-reference/feature-flags/renombrar-un-entorno.md) - [Evaluar cada indicador para una identidad](https://docs.mka1.com/api-reference/feature-flags/evaluar-cada-indicador-para-una-identidad.md): Resuelve cada bandera no archivada del entorno para una llamada anónima, o para la identidad proporcionada en la consulta. Envía un ETag y responde 304 a un If-None-Match coincidente después de autenticar la clave de evaluación del entorno. - [Evalúa cada bandera para una identidad con rasgos](https://docs.mka1.com/api-reference/feature-flags/evalúa-cada-bandera-para-una-identidad-con-rasgos.md) - [Revocar una clave de evaluación de entorno](https://docs.mka1.com/api-reference/feature-flags/revocar-una-clave-de-evaluación-de-entorno.md): La revocación es idempotente mientras el entorno exista. - [Generar o reemplazar una clave de evaluación del entorno](https://docs.mka1.com/api-reference/feature-flags/generar-o-reemplazar-una-clave-de-evaluación-del-entorno.md): Devuelve la nueva clave en texto plano una sola vez. Solo se almacenan su resumen SHA-256 y una pista de visualización; generar otra clave reemplaza inmediatamente la credencial anterior en esta réplica. - [Eliminar una bandera y su configuración en cada entorno](https://docs.mka1.com/api-reference/feature-flags/eliminar-una-bandera-y-su-configuración-en-cada-entorno.md) - [Obtener una bandera](https://docs.mka1.com/api-reference/feature-flags/obtener-una-bandera.md) - [Actualizar el nombre, la descripción, el valor predeterminado o el proyecto de una bandera](https://docs.mka1.com/api-reference/feature-flags/actualizar-el-nombre-la-descripción-el-valor-predeterminado-o-el-proyecto-de-una-bandera.md) - [Archivar una bandera](https://docs.mka1.com/api-reference/feature-flags/archivar-una-bandera.md): Las banderas archivadas se excluyen de la evaluación en todos los entornos; sus configuraciones se conservan. - [Reemplazar la configuración de una marca en un entorno](https://docs.mka1.com/api-reference/feature-flags/reemplazar-la-configuración-de-una-marca-en-un-entorno.md) - [Restaurar una marca archivada](https://docs.mka1.com/api-reference/feature-flags/restaurar-una-marca-archivada.md) ## OpenAPI Specs - [speakeasy](https://apigw.mka1.com/speakeasy.json?language=es) - [speakeasy](https://apigw.mka1.com/speakeasy.json?language=pt-BR)