For AI agents: an index of this documentation is at https://developer.rippling.com/llms.txt. Public pages have a Markdown version at the same URL with .md added.

Skip to main content
Beta

Developer sandboxes

Create and manage developer sandboxes using the Rippling CLI.

Use with AI:ChatGPT Claude Cursor

Access to the Rippling CLI is gated behind the Developer Program, which is currently in a closed beta.

rippling sandbox create​

Creates a new sandbox.

FlagTypeRequiredDescription
--namestringyesDisplay name.
--typestringyesSandbox type: developer or full data.
--descriptionstringnoSandbox description.
--config-override-filefilenoJSON for config_override. - reads stdin. developer.company_size accepts MEDIUM.
--inputfilenoFull JSON body from a file, or stdin with -. Cannot be combined with field flags.
--jsonbooleannoPrint the response as indented JSON.

Example:

rippling --context developer-account sandbox create --name "Editor" --type developer --json
rippling --context developer-account sandbox create --name "Editor" --type developer --config-override-file editor-sandbox-config.json --json

rippling sandbox list​

Lists available sandboxes.

FlagTypeRequiredDescription
--cursorstringnoPagination cursor.
--filterstringnoFilter expression.
--limitstringnoMaximum results. Default 10. Maximum 100.
--order-bystringnoSort expression.
--jsonbooleannoPrint the response as indented JSON.

Example:

rippling --context developer-account sandbox list
rippling --context developer-account sandbox list --json

rippling sandbox get​

Reads a specific sandbox.

FlagTypeRequiredDescription
--idstringyesSandbox ID to return.
--jsonbooleannoPrint the response as indented JSON.

Example:

rippling sandbox get --id <sandbox-id>
rippling sandbox get --id <sandbox-id> --json

rippling sandbox use​

Stores a sandbox as a named context and sets that context as the default.

FlagTypeRequiredDescription
--aliasstringnoDeveloper sandbox alias (handle).
--idstringnoDeveloper sandbox ID.
--context-namestringnoContext name to create or update.

Example:

rippling --context developer-account sandbox use --alias <handle> --context-name sandbox-editor
rippling --context developer-account sandbox use --id <sandbox-id> --context-name sandbox-installer

rippling api sandbox login​

Signs into a sandbox account.

FlagTypeRequiredDescription
--aliasstringnoDeveloper sandbox alias (handle). Pass this or --id.
--idstringnoDeveloper sandbox ID. Pass this or --alias.
--context-namestringnoContext name to create or update. Must differ from the developer-account context.

Example:

rippling --context developer-account api sandbox login --alias <handle> --context-name sandbox-editor

rippling sandbox delete​

Deletes a sandbox.

FlagTypeRequiredDescription
--idstringyesSandbox ID to delete.
--jsonbooleannoPrint the response as indented JSON.

Example:

rippling sandbox delete --id <sandbox-id>
rippling sandbox delete --id <sandbox-id> --json