# API Computer Control
SUMMARY: Contrôle à distance d'ordinateurs enregistrés — file d'attente de commandes, captures d'écran, exécution de scripts sur machines distantes.

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 Computer Control
L'API Computer Control permet de télécommander des ordinateurs enregistrés. Un
petit agent () s'exécute sur la machine cible, effectue le
polling des commandes, les exécute et renvoie les résultats. Cela permet
l'automatisation d'interface graphique pilotée par LLM.
Architecture
[CODE BLOCK]
Endpoints côté utilisateur (Mind Key ou JWT)
GET /computers/list
Liste tous les ordinateurs enregistrés.
[CODE BLOCK]
GET /computers/:id
Récupère les détails d'un seul ordinateur.
[CODE BLOCK]
POST /computers/install-code
Génère un code d'installation pour enregistrer un nouvel ordinateur.
[CODE BLOCK]
Réponse : 
POST /computers/:id/commands
Met en file d'attente une commande à exécuter par l'agent distant.
[CODE BLOCK]
Réponse : 
GET /computers/:id/command (via requête)
Met en file d'attente une commande via GET (pour les cas simples).
[CODE BLOCK]
GET /computers/:id/commands
Liste les commandes récentes d'un ordinateur.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Récupère le statut et le résultat d'une commande spécifique.
[CODE BLOCK]
GET /computers/:id/screenshot
Action unique : met en file d'attente une commande de capture d'écran et attend
jusqu'à 30 s le résultat.
[CODE BLOCK]
POST /computers/:id/disable
Désactive un ordinateur (révoque son jeton, conserve l'enregistrement pour audit).
[CODE BLOCK]
DELETE /computers/:id
Supprime définitivement un ordinateur.
[CODE BLOCK]
Endpoints côté agent (Computer Token)
Ces endpoints sont utilisés par le  s'exécutant sur la machine
cible. Ils utilisent un Computer Token (renvoyé par ), pas une
Mind Key.
POST /computers/register
Échange un code d'installation contre un Computer Token.
[CODE BLOCK]
Réponse : 
> [!CRITICAL]
> Sauvegardez le  — il n'est affiché qu'une seule fois et est requis
> pour tous les endpoints côté agent.
GET /computers/me/poll
Long-polling de nouvelles commandes. L'agent l'appelle en boucle.
[CODE BLOCK]
Renvoie immédiatement si des commandes sont en attente, ou après  secondes sinon.
POST /computers/me/commands/:cid/result
Publie le résultat de l'exécution d'une commande.
[CODE BLOCK]
Types de commandes
| Type | Payload | Description |
|------|---------|-------------|
|  |  | Capture l'écran en PNG (base64) |
|  |  | Clique aux coordonnées |
|  |  | Déplace la souris aux coordonnées |
|  |  | Saisit du texte au curseur |
|  |  | Appuie sur une combinaison de touches |
|  |  | Fait défiler à la molette |
|  |  | Glisser-déposer |
Schéma courant : automatisation d'interface graphique pilotée par LLM
[CODE BLOCK]
Prochaines étapes
- Proxy navigateur — service distinct pour l'automatisation de navigateur
- Guide des agents auto-hébergés