# API de Computer Control
SUMMARY: Control remoto de computadoras registradas — encolar comandos, tomar capturas de pantalla, ejecutar scripts en máquinas remotas.

KEY CONTEXT:
Two sides: user-facing (Mind Key/JWT) and agent-facing (Computer Token)
Register agent: POST /computers/register { install_code } → returns computer_token
List: GET /computers/list (Mind Key or JWT)
Queue command: POST /computers/:id/commands { type, payload }
Command types: screenshot, click, move, type, key, scroll, drag
Agent poll: GET /computers/me/poll?wait=5 (Computer Token)
Agent result: POST /computers/me/commands/:cid/result (Computer Token)
One-shot screenshot: GET /computers/:id/screenshot (waits 30s for result)
Pattern: register agent on remote machine → user queues commands → agent polls and executes

API de Computer Control
La API de Computer Control permite controlar de forma remota computadoras
registradas. Un pequeño agente () se ejecuta en la máquina
destino, realiza poll de comandos, los ejecuta y publica los resultados de
vuelta. Esto habilita la automatización GUI dirigida por LLM.
Arquitectura
[CODE BLOCK]
Endpoints del lado del usuario (Mind Key o JWT)
GET /computers/list
Lista todas las computadoras registradas.
[CODE BLOCK]
GET /computers/:id
Obtiene los detalles de una computadora individual.
[CODE BLOCK]
POST /computers/install-code
Genera un código de instalación para registrar una nueva computadora.
[CODE BLOCK]
Respuesta: 
POST /computers/:id/commands
Encola un comando para que el agente remoto lo ejecute.
[CODE BLOCK]
Respuesta: 
GET /computers/:id/command (vía query)
Encola un comando vía GET (para casos simples).
[CODE BLOCK]
GET /computers/:id/commands
Lista los comandos recientes de una computadora.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Obtiene el estado y resultado de un comando específico.
[CODE BLOCK]
GET /computers/:id/screenshot
One-shot: encola un comando de captura de pantalla y espera hasta 30s por el
resultado.
[CODE BLOCK]
POST /computers/:id/disable
Deshabilita una computadora (revoca su token, conserva el registro para
auditoría).
[CODE BLOCK]
DELETE /computers/:id
Elimina una computadora de forma permanente.
[CODE BLOCK]
Endpoints del lado del agente (Computer Token)
Estos endpoints los utiliza el  que se ejecuta en la
máquina destino. Usan un Computer Token (devuelto por ),
no un Mind Key.
POST /computers/register
Canjea un código de instalación y obtiene un Computer Token.
[CODE BLOCK]
Respuesta: 
> [!CRITICAL]
> Guarde el  — solo se muestra una vez y es obligatorio para
> todos los endpoints del lado del agente.
GET /computers/me/poll
Long-poll de comandos nuevos. El agente lo llama en bucle.
[CODE BLOCK]
Devuelve inmediatamente si hay comandos pendientes, o después de  segundos
si no los hay.
POST /computers/me/commands/:cid/result
Publica el resultado de ejecutar un comando.
[CODE BLOCK]
Tipos de comando
| Tipo | Payload | Descripción |
|------|---------|-------------|
|  |  | Captura la pantalla como PNG (base64) |
|  |  | Clic en las coordenadas |
|  |  | Mueve el ratón a las coordenadas |
|  |  | Escribe texto en el cursor |
|  |  | Pulsa una combinación de teclas |
|  |  | Rueda de desplazamiento |
|  |  | Arrastrar y soltar |
Patrón común: automatización GUI dirigida por LLM
[CODE BLOCK]
Próximos pasos
- Browser Proxy — servicio separado para automatización de navegador
- Guía de agentes self-hosted