---
title: "Create sandbox group"
method: POST
path: "/sandbox-groups"
tags: ["Sandboxes"]
---

# Create sandbox group

`POST /sandbox-groups`

## Request

- Base URL: `https://api.render.com/v1`
- URL: `https://api.render.com/v1/sandbox-groups`
- Auth: HTTP bearer

Create a sandbox group. The workspace's first group becomes its default.
Returns 409 if the `name` is taken.

## Request body

- object
  - `ownerId` string, required: Workspace ID.
  - `name` string, required: Name, unique within the workspace.
  - `region` string: Region for the group's sandboxes. Defaults to Render's default sandbox region.

## Response `201`

Sandbox group created.

- object
  - `id` Schema, required (unresolved $ref)
  - `ownerId` string, required: The ID of the workspace this group belongs to.
  - `name` string, required: Human-friendly name for the group.
  - `region` string, required: Render region the group operates in.
  - `isDefault` boolean, required: Whether this is the workspace's default group. Sandboxes are created here unless a group is given.
  - `environmentId` string, nullable: Environment this group is bound to.
  - `concurrencyLimit` integer, required: The effective limit on active sandboxes in this group, capped by Render's limit for this workspace.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: The request could not be understood by the server.
- `401`: Authorization information is missing or invalid.
- `403`: You do not have permissions for the requested resource. If a scoped API token does not satisfy the endpoint's minimum scope requirements, the response has code insufficient_token_scope and its message lists all minimum required scopes. Broader scopes that include their permissions also satisfy the requirements. Passing this check does not guarantee access to the requested resource or to conditional operations.
- `404`: Unable to find the requested resource.
- `409`: The current state of the resource conflicts with this request.
- `429`: Rate limit has been surpassed. Rate-limited endpoints also return `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` on successful responses so clients can track their remaining quota.
- `500`: An unexpected server error has occurred.
- `503`: Server currently unavailable.

## Changes

- **2026-11-03** `6ac5d3d47362`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/render/apis/render-public-api/changes/sandbox-groups/post.md)

---

[API](https://skmtc.dev/render/apis/render-public-api.md) - [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/render/apis/render-public-api/revisions/6ac5d3d47362?raw)