---
title: "Set engagement environment"
method: PUT
path: "/v1/engagement/env"
tags: ["Engagement"]
---

# Set engagement environment

`PUT /v1/engagement/env`

## Request

- Base URL: `https://app.aptrinsic.com`
- URL: `https://app.aptrinsic.com/v1/engagement/env`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/docs/v1/engagement/env/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
- env:  Which environment to set the engagement to.  Valid values: Production,Stage,QA,Integration (case insensitive)

## Request body

- EngagementEnvChangeRequest: Engagement state change request
  - `engagementId` string, required: ID of engagement to modify
  - `env` 'Production' | 'Stage' | 'QA' | 'Integration', required

## Response `200`

Success

- EngagementEnvChangeResponse: Engagement environment 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)