opsen
opsen

REST API

What the SDKs call. Every endpoint, with its schema, is at /api-reference.

OpenAPI schemaGenerated, always current Python clientWhat calls these ErrorsStatus codes and types

Authenticate with Authorization: Bearer osk_... or x-api-key. Base URL https://opsen.dev.

Sessions

methodpath
POST/v1/sessions
GET/v1/sessions
GET/v1/sessions/
DELETE/v1/sessions/
POST/v1/sessions//exec
GET/v1/sessions//host/

Cost

methodpath
GET/v1/costs
GET/v1/events
curl -X POST https://opsen.dev/v1/sessions \
  -H "Authorization: Bearer $OPSEN_API_KEY" \
  -H "content-type: application/json" \
  -d '{"task_id": "invoice-extract", "budget_usd": 2.00}'

The complete schema, generated from the server rather than written by hand, is at /api-reference.

PreviousPython client NextSandbox environment