Creates a template and queues the first build. The response includes
both the template id and the build id, so clients can immediately
poll GET /templates/{id} for overall status or subscribe to
GET /templates/{id}/builds/{build_id}/logs for live output.
Template starts in status building. Poll until it reaches ready
before creating sandboxes from it. On failure the status becomes
failed and error_message is populated.
To rebuild an existing template (e.g. after a failure or when the
base image updates), use POST /templates/{id}/builds.
Documentation Index
Fetch the complete documentation index at: https://docs.superserve.ai/llms.txt
Use this file to discover all available pages before exploring further.
Human-readable name, unique per team. Used as the from_template value when creating sandboxes. Lowercase letters, digits, and . _ / - only; must start and end with a letter or digit. Names starting with superserve/ are reserved for curated system templates and rejected for team-owned templates.
1 - 128^[a-z0-9]([a-z0-9._/-]*[a-z0-9])?$"my-python-env"
Declaration of how to build a template.
1 <= x <= 4256 <= x <= 40961024 <= x <= 8192Template created; first build queued
Returned by POST /templates — includes both the new template id
and the id of the first build that was queued for it. Clients can
immediately open the build-log SSE stream or poll the template for
status transitions.