API overview

Base URL: https://api.skilleo.org (Skilleo Cloud)

The public SDK (pip install skilleo) talks to this host by default.

All successful JSON responses use the envelope. Errors use a top-level error object.

Examples: authenticated requests use curl with Authorization: Bearer $SKILLEO_API_KEY. Set export SKILLEO_API_KEY='sk_live_...' after signup. Response shapes are documented as JSON where helpful; request examples are curl throughout this reference.

Resources

Prefix	Id prefix	Purpose
/v1/account	usr_, sk_live_, prv_	Signup, provider connections
/v1/compute	cmp_	GPU pods
/v1/storage	sto_	Network volumes
/v1/templates	tpl_	Worker images
/v1/endpoints	ep_	Serverless endpoints
/v1/jobs	job_	Async work
/v1/runs	run_	Capability (and later agent) execution
/v1/catalog	—	GPU and datacenter inventory
/v1/capabilities	—	Versioned capability discovery
/v1/artifacts	art_	Durable job outputs
/v1/workflows	wfl_	Capability-driven DAGs
/v1/agents	agt_	Specialist agent runs
/v1/plans	pln_	Planner output (no execution)
/v1/tasks	tsk_	User outcomes (manager loop)
/v1/billing	chk_	Paid developer access
/v1/usage	—	Metering and export

Common headers

Header	Use
Authorization: Bearer sk_live_...	Required on authenticated routes
Idempotency-Key	Optional on create routes
X-Request-ID	Returned on every response

See Platform availability and Runs.