# Machine instances

# Machine instance operations.

Machine instances are instances of a machine definition.

If you have a machine definition that controls a user onboarding flow,
you would want a machine instance for each user.

If you have a machine definition that controls access to a collaborative
document, you would want a machine instance for each document.

Machine instances have names that are unique within a machine definition.

You can send events to machine instances to trigger transitions and can
read the state of an instance.

## Consistency guarantees

Processing for a machine instance is coordinated such that there is
a single, linearizable history of events and state transitions.

## Limits

Machine context (represented as JSON) may not exceed 400kb.



## Operations
- [Create a new machine instance.](https://api-docs.statebacked.dev/operation/operation-post-machines-parameter.md)
- [List the instances of this machine](https://api-docs.statebacked.dev/operation/operation-get-machines-parameter-i.md)
- [Get the current state of a machine instance.](https://api-docs.statebacked.dev/operation/operation-get-machines-parameter-i-parameter.md)
- [Delete a machine instance and any transitions, state, or pending upgrades associated with it.](https://api-docs.statebacked.dev/operation/operation-delete-machines-parameter-i-parameter.md)
- [Query for machine instances using the indicated index.](https://api-docs.statebacked.dev/operation/operation-get-machines-parameter-indexes-parameter-query.md)
- [Get the administrative state of an instance](https://api-docs.statebacked.dev/operation/operation-get-machines-parameter-i-parameter-admin.md)
- [List the transitions for this machine instance](https://api-docs.statebacked.dev/operation/operation-get-machines-parameter-i-parameter-events.md)
- [Send an event to a machine instance.](https://api-docs.statebacked.dev/operation/operation-post-machines-parameter-i-parameter-events.md)
- [Update the desired machine version for an existing instance.](https://api-docs.statebacked.dev/operation/operation-put-machines-parameter-i-parameter-v.md)
- [Update the status of a machine instance](https://api-docs.statebacked.dev/operation/operation-put-machines-parameter-i-parameter-status.md)

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