# Computer Control API
SUMMARY: Bedien geregistreerde computers op afstand — commando's in de wachtrij, schermafbeeldingen, scripts uitvoeren op externe machines.

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

Computer Control API
De Computer Control API stelt u in staat geregistreerde computers op afstand te
bedienen. Een kleine agent () draait op de doelmachine, pollt
naar commando's, voert ze uit en stuurt de resultaten terug. Dit maakt door LLM
aangestuurde GUI-automatisering mogelijk.
Architectuur
[CODE BLOCK]
Gebruikersgerichte eindpunten (Mind Key of JWT)
GET /computers/list
Toon alle geregistreerde computers.
[CODE BLOCK]
GET /computers/:id
Haal details op van één computer.
[CODE BLOCK]
POST /computers/install-code
Genereer een installatiecode voor het registreren van een nieuwe computer.
[CODE BLOCK]
Respons: 
POST /computers/:id/commands
Plaats een commando in de wachtrij voor uitvoering door de externe agent.
[CODE BLOCK]
Respons: 
GET /computers/:id/command (via query)
Plaats een commando via GET (voor eenvoudige gevallen).
[CODE BLOCK]
GET /computers/:id/commands
Toon recente commando's voor een computer.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Haal status + resultaat van een specifiek commando op.
[CODE BLOCK]
GET /computers/:id/screenshot
Eenmalig: plaats een screenshot-commando in de wachtrij en wacht tot 30s op het resultaat.
[CODE BLOCK]
POST /computers/:id/disable
Schakel een computer uit (trekt het token in, behoudt het record voor controle).
[CODE BLOCK]
DELETE /computers/:id
Verwijder een computer permanent.
[CODE BLOCK]
Agent-gerichte eindpunten (Computer Token)
Deze eindpunten worden gebruikt door de  die draait op de
doelmachine. Ze gebruiken een Computer Token (geretourneerd door ),
geen Mind Key.
POST /computers/register
Wissel een installatiecode in en ontvang een Computer Token.
[CODE BLOCK]
Respons: 
> [!CRITICAL]
> Sla het  op — het wordt slechts één keer getoond en is vereist
> voor alle agent-gerichte eindpunten.
GET /computers/me/poll
Long-poll voor nieuwe commando's. De agent roept dit aan in een lus.
[CODE BLOCK]
Retourneert onmiddellijk als er commando's klaarstaan, of na  seconden als dat niet zo is.
POST /computers/me/commands/:cid/result
Stuur het resultaat van het uitvoeren van een commando.
[CODE BLOCK]
Commando-typen
| Type | Payload | Beschrijving |
|------|---------|--------------|
|  |  | Maak schermafbeelding als PNG (base64) |
|  |  | Klik op coördinaten |
|  |  | Verplaats muis naar coördinaten |
|  |  | Typ tekst op cursorpositie |
|  |  | Druk toetsencombinatie in |
|  |  | Scroll-wiel |
|  |  | Slepen en neerzetten |
Veelvoorkomend patroon: door LLM aangestuurde GUI-automatisering
[CODE BLOCK]
Volgende stappen
- Browser Proxy — aparte service voor browserautomatisering
- Self-Hosted Agents Guide