# StateTransition

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.StateTransition/

One state transition in a workflow.

- **Full name:** `MFiles.StateTransition`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-id"></a>`id` | `int32` | 1 | State transition ID. |
| <a id="f-from_state"></a>`from_state` | `int32` | 2 | The source state. |
| <a id="f-to_state"></a>`to_state` | `int32` | 3 | The target state. |
| <a id="f-evaluation_order"></a>`evaluation_order` | `int32` | 4 | The evaluation order. |
| <a id="f-name"></a>`name` | `string` | 5 | The name of the state. |
| <a id="f-description"></a>`description` | `string` | 6 | The description of the state. |
| <a id="f-acl"></a>`acl` | [`AccessControlList`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AccessControlList/index.md) | 7 | Transition permissions. |
| <a id="f-signature_settings"></a>`signature_settings` | [`ElectronicSignatureSettings`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ElectronicSignatureSettings/index.md) | 8 | Signature settings for this state transition. |
| <a id="f-trigger_mode"></a>`trigger_mode` | [`AutoStateTransitionMode`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.AutoStateTransitionMode/index.md) | 9 | The selected mode for automatically triggered state transition. Values: `AUTO_STATE_TRANSITION_MODE_NONE` (0), `AUTO_STATE_TRANSITION_MODE_RELATIVE_TIME` (1), `AUTO_STATE_TRANSITION_MODE_CRITERIA_FULFILLED` (4), `AUTO_STATE_TRANSITION_MODE_SCRIPT_FULFILLED` (5), `AUTO_STATE_TRANSITION_MODE_ASSIGNMENT_COMPLETE` (6), `AUTO_STATE_TRANSITION_MODE_ASSIGNMENT_REJECTED` (7). |
| <a id="f-trigger_in_days"></a>`trigger_in_days` | `uint32` | 10 | The number of days before automatically triggered state transition. |
| <a id="f-trigger_criteria"></a>`trigger_criteria` | repeated [`SearchCondition`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.SearchCondition/index.md) | 11 | The criteria for automatically triggered state transition. |
| <a id="f-trigger_code"></a>`trigger_code` | `string` | 12 | The VB script for automatically triggered state transition. |
| <a id="f-aliases"></a>`aliases` | `string` | 13 | Semicolon-separated list of semantic aliases. |
| <a id="f-vault_guids"></a>`vault_guids` | repeated `string` | 14 | An array of GUIDS of vaults where this state transition will be triggered. |
| <a id="f-user_description"></a>`user_description` | `string` | 15 | The user description of the state. |

<a id="used-in-fields"></a>

## Used in fields

- [`StateTransitionDecl.transition`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.StateTransitionDecl/index.md#f-transition): Other information on the state transition.
- [`WorkflowAdmin.transitions`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.WorkflowAdmin/index.md#f-transitions): The state transitions of this workflow.