API DOCUMENTATION

Integrate directly.

Submit isolated compute runs and manage your AgentCompute workspace from your backend or application.

01 · BASE URL

Platform API

All platform endpoints are relative to:

https://api.winsome.dev/platform/v1

Authenticate with an AgentCompute session or an API key where supported. Keep credentials server-side.

02 · RUNS

Execute and inspect

POST /runsStart a run with command, runtime, and optional resource settings.

GET /runsList recent runs for the authenticated workspace.

GET /runs/:idRead status, output, exit code, and timestamps.

POST /runs/:id/cancelCancel an active run.

03 · WORKSPACE

Projects, keys, and usage

GET|POST /projectsList or create projects.

GET /api-keysList workspace API keys.

POST /api-keys/:id/revokeRevoke an API key immediately.

GET /usageRead run and compute usage.

04 · EXAMPLE

Create a run

curl -X POST https://api.winsome.dev/platform/v1/runs \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"command":"print(42)","runtime":"python"}'

Run responses include a job ID. Poll GET /runs/:id until the status is complete, failed, or cancelled.