---
title: "Set engagement environments"
method: PUT
path: "/v1/engagement/envs"
tags: ["Engagement"]
---

# Set engagement environments

`PUT /v1/engagement/envs`

## Request

- Base URL: `https://app.aptrinsic.com`
- URL: `https://app.aptrinsic.com/v1/engagement/envs`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/docs/v1/engagement/envs/put.ts> (a function with typed inputs; its response is checked against the schema)

Move engagement between environments.
### Parameters
- engagementId: ID of engagement to be modified
- envs:  Which environments to set the engagement to.  Valid values: Production,Stage,QA,Integration (case insensitive)

## Request body

- EngagementEnvironmentsChangeRequest: Engagement environments change request
  - `engagementId` string, required: ID of engagement to modify
  - `envs` string[], required: Collection of environments

## Response `200`

Success

- EngagementEnvironmentsChangeResponse: Engagement environments change response
  - `errors` string[]
  - `status` integer

## Other responses

- `400`: Bad request
- `401`: Unauthorized or bad API Key
- `404`: Account not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api.md) - [All operations](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/revisions/e7b197b373d8?raw)