# Set engagement state

**PUT /v1/engagement/state**

Pauses or starts an engagement.
### Parameters
- engagementId: ID of engagement to be modified
- state:  Desired state for engagement (START or PAUSE)
- envs:  If changing the state to START, list of environments to start the engagement on, defaults to [PRODUCTION]




## Servers
- https://api.aptrinsic.com: https://api.aptrinsic.com ()



## Parameters



### Body: application/json (object)
Engagement State Change Request
- **engagementId** (string)
  ID of engagement to modify
- **state** (string)
  New state for given engagement
- **envs** (array[string])
  Collection of environments on which to change the state. Defaults to [PRODUCTION]


## Responses
### 200
Success

#### Body: application/json (object)
- **body** (object)

- **statusCode** (string)

- **statusCodeValue** (integer(int32))


### 400
Bad request

### 401
Unauthorized or bad API Key

### 404
Account not found

### 429
Rate limit exceeded


[Powered by Bump.sh](https://bump.sh)