---
title: "POST /v1alpha1/customers:provisionDeployment"
method: POST
path: "/v1alpha1/customers:provisionDeployment"
tags: ["customers"]
---

# POST /v1alpha1/customers:provisionDeployment

`POST /v1alpha1/customers:provisionDeployment`

## Request

- Base URL: `https://prod-tt-sasportal.googleapis.com`
- URL: `https://prod-tt-sasportal.googleapis.com/v1alpha1/customers:provisionDeployment`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/sasportal`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/sasportal`
- TypeScript: <https://skmtc.dev/google/apis/prod-tt-sasportal/docs/v1alpha1/customers:provisionDeployment/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new SAS deployment through the GCP workflow. Creates a SAS organization if an organization match is not found.

## Request body

- SasPortalProvisionDeploymentRequest: Request for [ProvisionDeployment]. [spectrum.sas.portal.v1alpha1.Provisioning.ProvisionDeployment]. GCP Project, Organization Info, and caller’s GAIA ID should be retrieved from the RPC handler, and used as inputs to create a new SAS organization (if not exists) and a new SAS deployment.
  - `organizationId` string, int64: Optional. If this field is set then a new deployment will be created under the organization specified by this id.
  - `newOrganizationDisplayName` string: Optional. If this field is set, and a new SAS Portal Organization needs to be created, its display name will be set to the value of this field.
  - `newDeploymentDisplayName` string: Optional. If this field is set, and a new SAS Portal Deployment needs to be created, its display name will be set to the value of this field.

## Response `200`

Successful response

- SasPortalProvisionDeploymentResponse: Response for [ProvisionDeployment]. [spectrum.sas.portal.v1alpha1.Provisioning.ProvisionDeployment].
  - `errorMessage` string: Optional. Optional error message if the provisioning request is not successful.

## Changes

- **2026-10-10** `33012279ba52`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/sasportal` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/sasportal` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/prod-tt-sasportal/changes/v1alpha1/customers:provisionDeployment/post.md)

---

[API](https://skmtc.dev/google/apis/prod-tt-sasportal.md) - [All operations](https://skmtc.dev/google/apis/prod-tt-sasportal/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/prod-tt-sasportal/revisions/33012279ba52?raw)