Skip to main content
List the sandbox templates available to the team from the CLI or the SDK. The SDK returns each template’s ID, aliases or names, resource sizing, visibility and build metadata.
Install the SDK, or the CLI for ppio commands, and set the PPIO_API_KEY and PPIO_DOMAIN environment variables before running these examples. See Quickstart and Install and authenticate.

List templates

Response

The response is paginated. The top-level fields are:
array
The templates on this page.
number
Total number of templates.
number
Current page number.
number
Items per page.
number
Total number of pages.

Assign tags

Tags label template builds for release management without changing the underlying template name. Use assign_tags in Python or assignTags in Node.js to assign one or more tags to an existing template build.

Remove tags

Use remove_tags in Python or removeTags in Node.js to remove one or more tags from a template by name.
assign_tags / assignTags returns tag information. remove_tags / removeTags returns nothing. Both accept a single tag string or a list of tags.

Delete a template

A template can be deleted by ID from the CLI or the SDK. Deleting a template is permanent.
Deleting a template is irreversible. The CLI asks for confirmation by default; pass -y or --yes to skip it. The CLI also removes the local ppio.toml config for the deleted template.

Publish and unpublish

Publishing makes a template public to everyone outside the team. Unpublishing makes it private to the team again. Both commands set the template’s public flag.
The command asks for confirmation before changing visibility, because publishing makes the template public to everyone outside the team. Pass -y or --yes to skip the prompt.

Usage

CLI

Arguments

Choose the templates to act on in one of three ways: pass [template], omit it to use ppio.toml, or pass --select.
string
Optional. Acts on the template with the given template ID. When omitted, uses the template defined by ppio.toml in the root directory.

Options

boolean
Selects templates from an interactive list, which shows only the templates eligible for the action.
string
Root directory where the command runs. Defaults to the current directory.
string
default:"./ppio.toml"
Path to the sandbox config toml.
string
Team ID the operation is associated with, used with --select.
boolean
Skips the manual confirmation prompt.

Examples

On success, publishing prints the public names the template was published as:
Output
Last modified on November 19, 2026