# Computer Control API
SUMMARY: Fjärrstyrning av registrerade datorer — köa kommandon, ta skärmdumpar, kör skript på fjärrmaskiner.

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
Computer Control API låter er fjärrstyra registrerade datorer. En liten agent
() körs på målmaskinen, pollar efter kommandon, kör dem
och skickar tillbaka resultat. Detta möjliggör LLM-driven GUI-automatisering.
Arkitektur
[CODE BLOCK]
Användarriktade endpoints (Mind Key eller JWT)
GET /computers/list
Lista alla registrerade datorer.
[CODE BLOCK]
GET /computers/:id
Hämta detaljer för en enskild dator.
[CODE BLOCK]
POST /computers/install-code
Generera en installationskod för att registrera en ny dator.
[CODE BLOCK]
Svar: 
POST /computers/:id/commands
Köa ett kommando för fjärragenten att utföra.
[CODE BLOCK]
Svar: 
GET /computers/:id/command (via query)
Köa ett kommando via GET (för enkla fall).
[CODE BLOCK]
GET /computers/:id/commands
Lista senaste kommandon för en dator.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Hämta status + resultat för ett specifikt kommando.
[CODE BLOCK]
GET /computers/:id/screenshot
One-shot: köa ett skärmdumpskommando och vänta upp till 30 s på resultatet.
[CODE BLOCK]
POST /computers/:id/disable
Inaktivera en dator (återkallar dess token, behåller posten för granskning).
[CODE BLOCK]
DELETE /computers/:id
Ta bort en dator permanent.
[CODE BLOCK]
Agentriktade endpoints (Computer Token)
Dessa endpoints används av  som körs på målmaskinen.
De använder en Computer Token (returnerad av ), inte en
Mind Key.
POST /computers/register
Lös in en installationskod och få en Computer Token.
[CODE BLOCK]
Svar: 
> [!CRITICAL]
> Spara  — den visas endast en gång och krävs för alla
> agentriktade endpoints.
GET /computers/me/poll
Lång-pollning efter nya kommandon. Agenten anropar denna i en loop.
[CODE BLOCK]
Returnerar omedelbart om kommandon väntar, eller efter  sekunder om inte.
POST /computers/me/commands/:cid/result
Skicka resultatet av ett utfört kommando.
[CODE BLOCK]
Kommandotyper
| Typ | Payload | Beskrivning |
|------|---------|-------------|
|  |  | Fånga skärm som PNG (base64) |
|  |  | Klicka vid koordinater |
|  |  | Flytta musen till koordinater |
|  |  | Skriv in text vid markören |
|  |  | Tryck tangentkombination |
|  |  | Rulla hjulet |
|  |  | Dra och släpp |
Vanligt mönster: LLM-driven GUI-automatisering
[CODE BLOCK]
Nästa steg
- Browser Proxy — separat tjänst för webbläsarautomatisering
- Self-Hosted Agents Guide