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:

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. Para autenticar sus solicitudes, incluya su clave API en el encabezado Authorization:

Autorización: Portador TU_CLAVE_API

Header de workspace

Las solicitudes autenticadas de la API deben incluir el header de contexto del workspace:

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.

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
`/agents/{id}`	GET	Obtener un agente específico	Obtener agente
`/agents/{id}/execute`	POST	Ejecutar un agente	Ejecutar agente
`/agent-responses/{id}`	GET	Obtener respuesta de ejecución del agente	Obtener respuesta del agente

Archivos del agente

Punto final	Método	Descripción	Documentación
`/agents/{agentId}/files`	GET	Listar archivos de agentes	Listar archivos de agentes
`/agents/{agentId}/files`	POST	Vincular archivos al agente	Vincular archivos al agente
`/agents/{agentId}/files/{fileId}`	ELIMINAR	Eliminar archivo de agente	Eliminar archivo de agente

Webhooks de agente

Punto final	Método	Descripción	Documentación
`/agents/{id}/webhooks`	GET	Listar webhooks de agentes	Listar webhooks de agentes
`/agents/{id}/webhooks`	POST	Crear webhook de agente	Crear webhook de agente

Workspaces

Punto final	Método	Descripción	Documentación
`/workspaces/usage`	GET	Historial de ejecuciones de agentes (uso del workspace)	Uso del workspace

Mission Control

Punto final	Método	Descripción	Documentación
`/mission-control/usage`	GET	Consumo de IA, ejecuciones y adopción del workspace	Uso de Mission Control

Eventos de auditoria

Punto final	Metodo	Descripcion	Documentacion
`/audit-events`	GET	Consulta eventos de auditoria del workspace para SIEM	Eventos de auditoria

Recuerdos

Punto final	Método	Descripción	Documentación
`/memories`	OBTENER	Listar todos los recuerdos	Listar recuerdos
`/memories`	POST	Crear un recuerdo	Crear recuerdo
`/memories/{memoryId}`	PARCHE	Actualizar una memoria	Actualizar memoria
`/memories/{memoryId}`	ELIMINAR	Eliminar un recuerdo	Eliminar recuerdo

Colecciones de recuerdos

Punto final	Método	Descripción	Documentación
`/memory-collections`	GET	Listar todas las colecciones	Listar colecciones
`/memory-collections`	POST	Crear una colección	Crear colección
`/memory-collections/{collection_id}`	PUT	Actualizar una colección	Actualizar colección
`/memory-collections/{collection_id}`	ELIMINAR	Eliminar una colección	Eliminar colección

Archivos

Punto final	Método	Descripción	Documentación
`/files`	GET	Listar todos los archivos	Listar archivos
`/files`	POST	Subir un archivo	Subir archivo
`/files/{fileId}`	GET	Obtener detalles del archivo	Obtener archivo
`/files/{fileId}`	ELIMINAR	Eliminar un archivo	Eliminar archivo
`/files/{fileId}/process`	POST	Procesar un archivo	Procesar archivo

Webhooks

Punto final	Método	Descripción	Documentación
`/webhooks`	GET	Listar todos los webhooks	Listar webhooks
`/webhooks/{id}`	ELIMINAR	Eliminar un webhook	Eliminar webhook

Versiones de agente

Endpoint	Método	Descripción	Documentación
`/agents/{id}/versions`	GET	Listar versiones del agente	Listar versiones del agente
`/agents/{id}/versions/{version_number}`	GET	Obtener versión del agente	Obtener versión del agente
`/agents/{id}/versions/{version_number}/rollback`	POST	Revertir versión del agente	Revertir versión del agente

Programaciones de agentes

Endpoint	Método	Descripción	Documentación
`/schedulers`	GET	Listar todas las programaciones	Listar todas las programaciones
`/agents/{agentId}/schedulers`	GET	Listar programaciones del agente	Listar programaciones del agente
`/agents/{agentId}/schedulers`	POST	Crear programación	Crear programación
`/agents/{agentId}/schedulers/{schedulerId}`	GET	Obtener programación	Obtener programación
`/agents/{agentId}/schedulers/{schedulerId}`	PUT	Actualizar programación	Actualizar programación
`/agents/{agentId}/schedulers/{schedulerId}`	DELETE	Eliminar programación	Eliminar programación
`/agents/{agentId}/schedulers/by-root-execution/{agentRootIdExecution}`	DELETE	Eliminar programaciones por ejecución raíz	Eliminar programaciones por ejecución raíz

Artifacts

Endpoint	Método	Descripción	Documentación
`/artifacts`	GET	Listar artifacts	Listar artifacts
`/artifacts`	POST	Crear artifact	Crear artifact
`/artifacts/{universal_id}`	GET	Obtener artifact	Obtener artifact
`/artifacts/{universal_id}`	PATCH	Renombrar artifact	Renombrar artifact
`/artifacts/{universal_id}`	DELETE	Eliminar artifact	Eliminar artifact
`/artifacts/{universal_id}/edit`	POST	Editar artifact	Editar artifact
`/artifacts/{universal_id}/publish`	POST	Publicar versión del artifact	Publicar versión del artifact
`/artifacts/{universal_id}/publish`	DELETE	Despublicar artifact	Despublicar artifact
`/artifacts/{universal_id}/restore`	POST	Restaurar versión del artifact	Restaurar versión del artifact
`/artifacts/{universal_id}/share`	POST	Compartir o dejar de compartir artifact	Compartir o dejar de compartir artifact
`/artifacts/{universal_id}/versions`	GET	Listar versiones del artifact	Listar versiones del artifact
`/artifacts/{universal_id}/versions/{version}`	DELETE	Eliminar versión del artifact	Eliminar versión del artifact
`/artifact-templates`	GET	Listar plantillas de artifact	Listar plantillas de artifact

Importación de recuerdos

Endpoint	Método	Descripción	Documentación
`/memory-import`	POST	Importar recuerdos desde texto	Importar recuerdos desde texto
`/memory-import/{id}`	GET	Obtener estado de la importación de recuerdos	Obtener estado de la importación de recuerdos

Cuenta

Endpoint	Método	Descripción	Documentación
`/me`	GET	Obtener usuario actual	Obtener usuario actual

Respuestas de agentes

Endpoint	Método	Descripción	Documentación
`/agent-responses`	GET	Listar respuestas de agentes	Listar respuestas de agentes

Referencias y visibilidad de archivos

Endpoint	Método	Descripción	Documentación
`/files/resolve`	POST	Resolver referencia de archivo	Resolver referencia de archivo
`/files/{fileId}/visibility`	PATCH	Actualizar visibilidad del archivo	Actualizar visibilidad del archivo

IDs de colecciones de recuerdos

Endpoint	Método	Descripción	Documentación
`/memory-collections/ids`	GET	Listar IDs de colecciones	Listar IDs de colecciones

Digital Employees

Endpoint	Método	Descripción	Documentación
`/digital-employees/capabilities`	GET	Obtener capacidades	Obtener capacidades
`/digital-employees`	GET	Listar Digital Employees	Listar Digital Employees
`/digital-employees/standalone`	POST	Crear empleado independiente	Crear empleado independiente
`/digital-employees/agents/{agentId}`	POST	Crear empleado desde un agente	Crear empleado desde un agente
`/digital-employees/{employeeId}`	GET	Obtener Digital Employee	Obtener Digital Employee
`/digital-employees/{employeeId}`	PUT	Actualizar Digital Employee	Actualizar Digital Employee
`/digital-employees/{employeeId}/duplicate`	POST	Duplicar Digital Employee	Duplicar Digital Employee
`/digital-employees/{employeeId}`	DELETE	Eliminar Digital Employee	Eliminar Digital Employee
`/digital-employees/schedule-preview`	POST	Previsualizar programación	Previsualizar programación
`/digital-employees/{employeeId}/invoke`	POST	Invocar Digital Employee	Invocar Digital Employee
`/digital-employees/{employeeId}/runs/{runId}/retry`	POST	Reintentar ejecución	Reintentar ejecución
`/digital-employees/{employeeId}/runs`	GET	Listar ejecuciones	Listar ejecuciones
`/digital-employees/{employeeId}/runs/{runId}`	GET	Obtener ejecución	Obtener ejecución
`/digital-employees/{employeeId}/runs/{runId}/output`	GET	Obtener salida de la ejecución	Obtener salida de la ejecución
`/digital-employees/{employeeId}/runs/{runId}/stream`	GET	Transmitir ejecución	Transmitir ejecución
`/digital-employees/{employeeId}/pause`	POST	Pausar Digital Employee	Pausar Digital Employee
`/digital-employees/{employeeId}/resume`	POST	Reanudar Digital Employee	Reanudar Digital Employee
`/digital-employees/{employeeId}/rollback-options`	GET	Obtener opciones de reversión	Obtener opciones de reversión
`/digital-employees/{employeeId}/rollback`	POST	Revertir Digital Employee	Revertir Digital Employee
`/digital-employees/{employeeId}/reparent`	POST	Reasignar padre del Digital Employee	Reasignar padre del Digital Employee
`/digital-employees/{employeeId}/detach`	POST	Desvincular Digital Employee	Desvincular Digital Employee
`/digital-employees/{employeeId}/runs/summary`	GET	Obtener resumen de ejecuciones	Obtener resumen de ejecuciones
`/digital-employees/{employeeId}/activity`	GET	Obtener registro de actividad	Obtener registro de actividad
`/digital-employees/{employeeId}/files`	GET	Obtener archivos del empleado	Obtener archivos del empleado
`/digital-employees/{employeeId}/goal`	PUT	Actualizar objetivo	Actualizar objetivo
`/digital-employees/{employeeId}/approve`	POST	Aprobar solicitud de contratación	Aprobar solicitud de contratación
`/digital-employees/{employeeId}/reject`	POST	Rechazar solicitud de contratación	Rechazar solicitud de contratación
`/digital-employees/avatar-upload`	POST	Subir avatar	Subir avatar
`/digital-employees/template-packs/agents/{agentId}`	GET	Exportar paquete de plantilla	Exportar paquete de plantilla
`/digital-employees/template-packs/preview-import`	POST	Previsualizar importación de plantilla	Previsualizar importación de plantilla
`/digital-employees/template-packs/import`	POST	Importar paquete de plantilla	Importar paquete de plantilla

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:

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.

Guía de API

Referencia de API

Integraciones

Protocolo de Contexto de Modelo (MCP)

URL base

Autenticación

Header de workspace

Puntos finales de la API

Agentes

Archivos del agente

Webhooks de agente

Workspaces

Mission Control

Eventos de auditoria

Recuerdos

Colecciones de recuerdos

Archivos

Webhooks

Versiones de agente

Programaciones de agentes

Artifacts

Importación de recuerdos

Cuenta

Respuestas de agentes

Referencias y visibilidad de archivos

IDs de colecciones de recuerdos

Digital Employees

Formato de solicitud

Formato de respuesta

​URL base

​Autenticación

​Header de workspace

​Puntos finales de la API

​Agentes

​Archivos del agente

​Webhooks de agente

​Workspaces

​Mission Control

​Eventos de auditoria

​Recuerdos

​Colecciones de recuerdos

​Archivos

​Webhooks

​Versiones de agente

​Programaciones de agentes

​Artifacts

​Importación de recuerdos

​Cuenta

​Respuestas de agentes

​Referencias y visibilidad de archivos

​IDs de colecciones de recuerdos

​Digital Employees

​Formato de solicitud

​Formato de respuesta

URL base

Autenticación

Header de workspace

Puntos finales de la API

Agentes

Archivos del agente

Webhooks de agente

Workspaces

Mission Control

Eventos de auditoria

Recuerdos

Colecciones de recuerdos

Archivos

Webhooks

Versiones de agente

Programaciones de agentes

Artifacts

Importación de recuerdos

Cuenta

Respuestas de agentes

Referencias y visibilidad de archivos

IDs de colecciones de recuerdos

Digital Employees

Formato de solicitud

Formato de respuesta