---
title: "Create a new data plane"
method: POST
path: "/orgs/current/data-planes"
tags: ["data_planes"]
---

# Create a new data plane

`POST /orgs/current/data-planes`

Creates a new data plane object. Persists the rendered data plane spec, and returns 202 with the data plane in status=requested. Requires BYOC enabled org and org admin.

## Request body

- DataPlanesCreateDataPlaneRequestAws
  - `external_id` string — ExternalID is the value LangSmith presents as ExternalId when assuming role_arn. Must match the ExternalId condition in the customer role's trust policy. Required.
  - `name` string
  - `region` string
  - `role_arn` string
  - `vpc_cidr` string

## Response `202`

Data plane requested

- DataPlanesPublicDataPlane
  - `api_url` string
  - `created_at` string
  - `id` string
  - `name` string
  - `region` string
  - `status` 'requested' | 'provisioning' | 'provisioning_failed' | 'active' | 'inactive' | 'deprovisioning' | 'deleted' | 'revoked'
  - `status_updated_at` string
  - `workspaces` DataPlanesPublicDataPlaneWorkspace[]
    - `id` string
    - `name` string

## Other responses

- `400` — Invalid input
- `401` — Unauthorized
- `403` — BYOC not enabled or insufficient permissions
- `409` — Name already exists for this organization
- `500` — Internal server error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)