> ## Documentation Index > Fetch the complete documentation index at: https://docs.tess.im/llms.txt > Use this file to discover all available pages before exploring further. # Visión General ¡Bienvenido a la documentación de la API de Tess AI! Esta guía te ayudará a empezar a usar nuestra API y a comprender cómo integrar las potentes capacidades de Tess AI en tus aplicaciones. ### **URL base** Todas las solicitudes a la API deben realizarse a la siguiente URL base: ```text theme={null} theme={null} https://api.tess.im ``` ## **Autenticación** Todas las solicitudes a la API requieren autenticación mediante una clave API. Puede obtener su clave API en el [Panel de control de Tess AI](https://tess.im/dashboard). Para autenticar sus solicitudes, incluya su clave API en el encabezado `Authorization`: ```text theme={null} theme={null} Autorización: Portador TU_CLAVE_API ``` ## **Header de workspace** Las solicitudes autenticadas de la API deben incluir el header de contexto del workspace: ```text theme={null} theme={null} x-workspace-id: YOUR_WORKSPACE_ID ``` **Obligatorio a partir del 01/09/2026** para la ejecución de agentes y demás endpoints autenticados de la API. Hasta entonces, si se omite, la API usa el workspace seleccionado del usuario (deprecated). Después de la fecha, ausencia → **422**. Ver [Errors](/es/errors). ## **Puntos finales de la API** La API de Tess AI proporciona las siguientes categorías principales de puntos finales: #### **Agentes** | **Punto final** | **Método** | **Descripción** | **Documentación** | | :---------------------- | :--------- | :---------------------------------------- | :--------------------------------------------------------------------- | | `/agents` | GET | Listar todos los agentes | [Listar agentes](https://docs.tess.im/es/list-agents) | | `/agents/{id}` | GET | Obtener un agente específico | [Obtener agente](https://docs.tess.im/es/get-agent) | | `/agents/{id}/execute` | POST | Ejecutar un agente | [Ejecutar agente](https://docs.tess.im/es/execute-agent) | | `/agent-responses/{id}` | GET | Obtener respuesta de ejecución del agente | [Obtener respuesta del agente](https://docs.tess.im/es/agent-response) | #### **Archivos del agente** | **Punto final** | **Método** | **Descripción** | **Documentación** | | :--------------------------------- | :--------- | :-------------------------- | :---------------------------------------------------------------------- | | `/agents/{agentId}/files` | GET | Listar archivos de agentes | [Listar archivos de agentes](https://docs.tess.im/es/list-agent-files) | | `/agents/{agentId}/files` | POST | Vincular archivos al agente | [Vincular archivos al agente](https://docs.tess.im/es/link-files) | | `/agents/{agentId}/files/{fileId}` | ELIMINAR | Eliminar archivo de agente | [Eliminar archivo de agente](https://docs.tess.im/es/delete-agent-file) | #### **Webhooks de agente** | **Punto final** | **Método** | **Descripción** | **Documentación** | | :---------------------- | :--------- | :------------------------- | :------------------------------------------------------------------------ | | `/agents/{id}/webhooks` | GET | Listar webhooks de agentes | [Listar webhooks de agentes](https://docs.tess.im/es/list-agent-webhooks) | | `/agents/{id}/webhooks` | POST | Crear webhook de agente | [Crear webhook de agente](https://docs.tess.im/es/create-agent-webhook) | #### **Workspaces** | **Punto final** | **Método** | **Descripción** | **Documentación** | | :------------------ | :--------- | :------------------------------------------------------ | :----------------------------------------------------------- | | `/workspaces/usage` | GET | Historial de ejecuciones de agentes (uso del workspace) | [Uso del workspace](https://docs.tess.im/es/workspace-usage) | #### **Eventos de auditoria** | **Punto final** | **Metodo** | **Descripcion** | **Documentacion** | | :-------------- | :--------- | :---------------------------------------------------- | :----------------------------------------------------------- | | `/audit-events` | GET | Consulta eventos de auditoria del workspace para SIEM | [Eventos de auditoria](https://docs.tess.im/es/audit-events) | #### **Recuerdos** | **Punto final** | **Método** | **Descripción** | **Documentación** | | :--------------------- | :--------- | :------------------------- | :---------------------------------------------------------- | | `/memories` | OBTENER | Listar todos los recuerdos | [Listar recuerdos](https://docs.tess.im/es/list-memories) | | `/memories` | POST | Crear un recuerdo | [Crear recuerdo](https://docs.tess.im/es/create-memory) | | `/memories/{memoryId}` | PARCHE | Actualizar una memoria | [Actualizar memoria](https://docs.tess.im/es/update-memory) | | `/memories/{memoryId}` | ELIMINAR | Eliminar un recuerdo | [Eliminar recuerdo](https://docs.tess.im/es/delete-memory) | #### **Colecciones de recuerdos** | **Punto final** | **Método** | **Descripción** | **Documentación** | | :------------------------------------ | :--------- | :--------------------------- | :---------------------------------------------------------------- | | `/memory-collections` | GET | Listar todas las colecciones | [Listar colecciones](https://docs.tess.im/es/list-collections) | | `/memory-collections` | POST | Crear una colección | [Crear colección](https://docs.tess.im/es/create-collection) | | `/memory-collections/{collection_id}` | PUT | Actualizar una colección | [Actualizar colección](https://docs.tess.im/es/update-collection) | | `/memory-collections/{collection_id}` | ELIMINAR | Eliminar una colección | [Eliminar colección](https://docs.tess.im/es/delete-collection) | #### **Archivos** | **Punto final** | **Método** | **Descripción** | **Documentación** | | :------------------------ | :--------- | :--------------------------- | :------------------------------------------------------- | | `/files` | GET | Listar todos los archivos | [Listar archivos](https://docs.tess.im/es/list-files) | | `/files` | POST | Subir un archivo | [Subir archivo](https://docs.tess.im/es/upload-file) | | `/files/{fileId}` | GET | Obtener detalles del archivo | [Obtener archivo](https://docs.tess.im/es/get-file) | | `/files/{fileId}` | ELIMINAR | Eliminar un archivo | [Eliminar archivo](https://docs.tess.im/es/delete-file) | | `/files/{fileId}/process` | POST | Procesar un archivo | [Procesar archivo](https://docs.tess.im/es/process-file) | #### **Webhooks** | **Punto final** | **Método** | **Descripción** | **Documentación** | | :--------------- | :--------- | :------------------------ | :--------------------------------------------------------- | | `/webhooks` | GET | Listar todos los webhooks | [Listar webhooks](https://docs.tess.im/es/list-webhooks) | | `/webhooks/{id}` | ELIMINAR | Eliminar un webhook | [Eliminar webhook](https://docs.tess.im/es/delete-webhook) | ## **Formato de solicitud** La mayoría de los puntos finales de la API aceptan cuerpos de solicitud codificados en JSON. Asegúrese de incluir el siguiente encabezado en sus solicitudes: ```text theme={null} theme={null} Tipo de contenido: aplicación/json ``` ## **Formato de respuesta** Todas las respuestas de la API se devuelven en formato JSON. Una respuesta exitosa generalmente tendrá un código de estado HTTP `2xx` y contendrá los datos solicitados. Las respuestas de error tendrán un código de estado `4xx` o `5xx` e incluirán un mensaje de error.