# Create a new machine instance.

**POST /machines/{machineSlug}**

Create a new instance of the machine definition with the given slug.

The `allowWrite` function for the machine definition version will be called
to authorize the initial transition and, if it fails, a 403 with code
`rejected-by-machine-authorizer` will be returned.

Otherwise, the state of the machine instance after the initial transition
will be returned.

All top-level events have a 10 second timeout for the machine to settle.
Settling means that the machine has reached a stable state and has no
child services running.

If the machine does not settle within 10 seconds but has completed at least
one transition successfully, a 200 with the current state will be returned,
the child services will be stopped, and error events will be delivered for
each stopped service before the next event is sent.

If a machine instance for this (`machineSlug`, instance `slug`) already exists,
a 409 will be returned.



## 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 to create an instance of.


### Body:  (object)
Request to create an instance of a machine.

If machineVersionId is provided, creates an instance of the machine
definition version with that ID. Otherwise, creates an instance of the
current version of the machine definition.

- **slug** (string)
  An identifier for the machine instance. Must be unique within the instances for the associated machine definition.
- **context** (object)
  The initial context for the machine instance.
  Defaults to `{}`.
- **machineVersionId** (string)
  The ID of the machine definition version to use for this instance.
  If not provided, creates an instance of the current version of the machine definition.


## Responses
### 200
The machine instance was created successfully.

#### Body:  (object)
- **ts** (number)
  Timestamp for when the state was created
- **state** (string | object)

- **publicContext** (object)
  The public context of the machine instance.

  This includes all context under the `public` key.
- **tags** (array[string])
  Array of tags for the current states
- **done** (boolean)
  Is the state machine complete

### 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)