Skip to main content
PUT
Promote an environment request

Authorizations

Authorization
string
header
required

Azure AD app-only access token. Obtain it from GET /v1/oauthToken and send it as the Authorization: Bearer {token} header.

Path Parameters

environmentRequestId
string<uuid>
required

Environment request ID.

Query Parameters

username
string
required

Username used to provision the new app.

password
string
required

Password for the provisioning account.

settingsID
string<uuid>
required

Governance settings ID to apply.

Body

application/json

Supply either a SecurityTemplateID or both AdminUsersStr and GenericUsersStr. SiteCollection must belong to your tenant.

RequestID
string<uuid>
required

ID of the environment request being promoted.

SiteCollection
string
required

Target site collection URL.

Title
string
EnvironmentType
enum<string>

Environment type.

Available options:
Sandbox,
UAT,
Production,
NA
Site
string
NewSiteUrl
string
SecurityTemplateID
string<uuid>
AdminUsersStr
string
GenericUsersStr
string
PrintViewersStr
string
AppInstanceID
string
Rationale
string

Response

Successful operation

RequestID
string<uuid>
Title
string
EnvironmentType
enum<string>

Environment type.

Available options:
Sandbox,
UAT,
Production,
NA
RequestStatus
enum<string>

Request lifecycle status.

Available options:
AwaitingApproval,
Accepted,
NotAccepted,
Processing,
Completed,
Failed
SecurityTemplateID
string<uuid> | null
AdminUsersStr
string
GenericUsersStr
string
PrintViewersStr
string
SiteCollection
string
Site
string
NewSiteUrl
string
URL
string
AppInstanceID
string
Rationale
string
Author
string
Created
string<date-time> | null