API overview
Base URL, conventions and every endpoint.
Base URL
https://usegasket.xyz/api/v1- JSON in, JSON out.
- Authorization: Bearer
gsk_test_…orgsk_live_… - Every response has an x-request-id header and x-gasket-latency-ms.
- Money is in USD micros: 1,000,000 = $1.
- Errors: { error: { code, message }, request_id }.
| Method | Path | Scope | Billing |
|---|---|---|---|
| POST | /v1/agents/:id/runs | agents:run | model tokens + $0.02 per tool call |
| POST | /v1/runs/:id/continue | agents:run | model tokens |
| GET | /v1/runs, /v1/runs/:id, /v1/agents/:id/runs | agents:read | free |
| GET | /v1/agents, /v1/agents/:id | agents:read | free |
| POST | /v1/actions | actions:write | $0.02 per new action |
| POST | /v1/actions/:id/result | actions:write | free |
| GET | /v1/actions, /v1/actions/:id | actions:read | free |
| GET | /v1/policies | policies:read | free |
| GET | /v1/events, /v1/balance | activity:read | free |
| POST | /v1/mcp | actions:write | $0.02 per request_permission |
Something wrong or missing? Tell us · Stuck? Help center