Docs
Templates ›

Get template start

GET/v1/templates/{id}/start

What a sandbox made from the template starts as: its size, a snapshot or a new machine, and how long it runs after each start.

RequestTypeScript
  1. import { Agental } from "agental-sdk";
  2. const agental = new Agental();
  3. const template = await agental.templates.get("tpl_0123456789abcdef");
  4. const start = await template.start();
Answer200 OK · TemplateStart
  1. {
  2. "size": "tiny" | "small" | "medium" | "large",
  3. "snapshotId": string | null,
  4. "ttlSeconds": integer | null,
  5. }

The template's start.

Path

idrequired
string
e.g. "tpl_0123456789abcdef"

Headers

Authorizationrequired
Bearer key
An API key that may make this call.

Returns

200 The template's start.

TemplateStart3 fields
size
tinysmallmediumlarge
The size a sandbox made from the template is, when the create names none.
snapshotId
stringnull
The snapshot a sandbox made from the template starts as, when the create names none.
More Null starts a new machine.
ttlSeconds
integernull
Seconds a sandbox made from the template runs after each start before it is stopped, when the create names none.
More Null is the deployment's default.

Errors and other answers

404 Not found.

Every error answers { "error": { "code", "message" } }; a key without the action a call needs answers 403 key_action_forbidden, naming it.