# Update the status of a machine instance

**PUT /machines/{machineSlug}/i/{instanceSlug}/status**

Set the status of the machine.

Machines in the 'paused' status will reject any events sent to them
with a 409 error with a code of "invalid-state".

'running' instances will accept events normally.

It is **dangerous** to set an instance's status to 'paused'!
You will drop events and, because delayed events are only retried
5 times (with ~30 seconds between each try), some delayed events
may be dropped and **never** sent to your machine.

This exists **purely** to stop a runaway machine instance that is
stuck in a loop of creating too many events.

This endpoint requires admin access.



## Servers
- Production server: https://api.statebacked.dev (Production server)


## Authentication methods
- Bearer auth


## Parameters

### Path parameters
- **machineSlug** (string)
  The slug/name for the machine definition.
- **instanceSlug** (string)
  The slug/name for the machine instance.


### Body:  (object)
Request to update the status of an existing instance.

- **status** (string)
  The status of a machine instance.


## Responses
### 204
The instance status was set.


### 400
The request was malformed.

#### Body:  (object)
- **error** (string)
  A description of the error.
- **code** (string)
  A code specifying the type of error.

  - `specify-org` indicates that the user has access to multiple orgs and the operation requires specifying an organization. Pass the `x-statebacked-org-id` header to specify an org ID.
  - `invalid-parameter` indicates that one of the provided parameters was incorrect
- **parameter** (string)
  The name of the invalid parameter

### 403
The request was unauthorized.

#### Body:  (object)
- **error** (string)
  A description of the error.
- **code** (string)
  A code specifying the type of error.

### 409
The resource already exists.

#### Body:  (object)
- **code** (string)
  Machine-readable identifier for the type of error
- **error** (string)
  Human-readable identifier for the error


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