Docs

Simple API reference for the current product.

API keys are the current access credential and the public API base URL is shown below for direct copy-and-paste use.

https://api.disposable-exec.com

Authentication

Send your API key in the Authorization header for all account and execution endpoints.

Authorization: Bearer YOUR_API_KEY

GET /me

Returns your current plan, subscription state, quota, and usage.

curl -s https://api.disposable-exec.com/me \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "user_id": "user_123",
  "effective_plan": "starter",
  "subscription_status": "active",
  "effective_quota_monthly": 3000,
  "usage_this_period": 12
}

GET /apikey

Lists API keys associated with the current account.

curl -s https://api.disposable-exec.com/apikey \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /apikey

Creates a new API key. Raw keys are shown once in the response.

curl -s -X POST https://api.disposable-exec.com/apikey \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name":"server-key"}'

{
  "id": "key_123",
  "name": "server-key",
  "api_key": "dex_live_..."
}

DELETE /apikey/{key_id}

Disables an existing API key by key id.

curl -s -X DELETE https://api.disposable-exec.com/apikey/key_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /run

Submits a short-lived execution request.

curl -s -X POST https://api.disposable-exec.com/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"script":"print(\"hello\")"}'

{
  "execution_id": "exec_123",
  "status": "queued"
}

GET /status/{execution_id}

Checks whether a submitted execution is queued, running, or finished.

curl -s https://api.disposable-exec.com/status/exec_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "execution_id": "exec_123",
  "status": "completed"
}

GET /result/{execution_id}

Fetches the final output for a completed execution.

curl -s https://api.disposable-exec.com/result/exec_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "execution_id": "exec_123",
  "stdout": "hello\n",
  "stderr": "",
  "exit_code": 0
}