List sandboxes
List sandboxes you can access in an org, optionally a single project, filtered by scope (mine|shared|all). Org-owners and project-admins may pass all_owners for oversight.
List sandboxes you can access in an org, optionally a single project, filtered by scope (mine|shared|all). Org-owners and project-admins may pass all_owners for oversight.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Query Parameters
Organization slug.
Project slug. Omit for org-wide (across all your projects in the org).
Which sandboxes, by your relationship to them.
"mine""mine" | "shared" | "all"Admin oversight: include everyone's sandboxes (incl. private). Requires project-admin (with project) or org-owner (org-wide).
Admin filter: restrict to this owner (email or user-id). Only valid with all_owners.
Admin filter: only sandboxes created before now minus this duration (e.g. 24h). Only valid with all_owners.
Admin filter: only sandboxes whose owner can no longer manage them. Only valid with all_owners.
Include soft-deleted sandboxes (state 'deleted'). Off by default.
Filter by sandbox state. May be repeated.
Opaque pagination cursor from a previous response
Maximum number of items to return (1–100)
20int321 <= value <= 100Response Body
application/json
application/problem+json
curl -X GET "https://api-dev.tektona.ai/v1/sandboxes?org=string"{ "$schema": "https://api-dev.tektona.ai/schemas/ListSandboxesBody.json", "effective_role": "none", "items": [ { "$schema": "https://api-dev.tektona.ai/schemas/GetSandboxResponse.json", "access": "read", "created_at": "string", "effective_role": "none", "egress_network_policy": { "name": "string" }, "egress_proxy_profile": { "name": "string" }, "id": "string", "image": "string", "lifecycle": { "$schema": "https://api-dev.tektona.ai/schemas/LifecycleResponse.json", "auto_delete_after": "string", "auto_pause_after": "string", "auto_pause_mode": "string", "auto_resume": true, "configured": { "auto_delete_after": "string", "auto_pause_after": "string", "auto_pause_mode": "string", "auto_resume": true }, "source": { "auto_delete_after": "own", "auto_pause_after": "own", "auto_pause_mode": "own", "auto_resume": "own" } }, "location": "string", "owner": { "email": "string", "id": "string", "name": "string" }, "project": { "display_name": "string", "id": "string", "name": "string", "org": "string", "slug": "string" }, "public": true, "resources": { "cpu": 2, "disk": 10, "memory": 2 }, "share_type": "none", "state": "string" } ], "pagination": { "has_more": true, "next_cursor": "string", "total_count": 0 }}{ "$schema": "https://api-dev.tektona.ai/schemas/ErrorModel.json", "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}