# Create Transition Request

Launch stage: GA

`POST /api/2.0/mlflow/transition-requests/create`

Creates a model version stage transition request.

API scopes: mlflow

## Request body

- `name` (string, optional)
  Name of the model.
  Example: `search_ads_model`
  Constraints: `[ 1 .. 100 ] characters`
- `version` (string, optional)
  Version of the model.
  Example: `1`
- `stage` (string, optional)
  Target stage of the transition. Valid values are:
   
   * `None`: The initial stage of a model version.
   
   * `Staging`: Staging or pre-production stage.
   
   * `Production`: Production stage.
   
   * `Archived`: Archived stage.
- `comment` (string, optional)
  User-provided comment on the action.
  Example: `This version is great!`
  Constraints: `[ 1 .. 65535 ] characters`

## Returns

- `request` (object, optional)
  New activity generated for stage transition request.
  - `creation_timestamp` (int64, optional)
    Creation time of the object, as a Unix timestamp in milliseconds.
    Example: `1594437249910`
  - `user_id` (string, optional)
    The username of the user that created the object.
    Example: `jane.doe@example.com`
  - `activity_type` (string, optional)
    Possible values: `APPLIED_TRANSITION`, `REQUESTED_TRANSITION`, `CANCELLED_REQUEST`, `APPROVED_REQUEST`, `REJECTED_REQUEST`, `NEW_COMMENT`, `SYSTEM_TRANSITION`
  - `comment` (string, optional)
    User-provided comment associated with the activity, comment, or transition request.
    Example: `This version is great!`
    Constraints: `[ 1 .. 65535 ] characters`
  - `last_updated_timestamp` (int64, optional)
    Time of the object at last update, as a Unix timestamp in milliseconds.
    Example: `1594437549910`
  - `from_stage` (string, optional)
    Source stage of the transition (if the activity is stage transition related). Valid values are:
     
     * `None`: The initial stage of a model version.
     
     * `Staging`: Staging or pre-production stage.
     
     * `Production`: Production stage.
     
     * `Archived`: Archived stage.
  - `to_stage` (string, optional)
    Target stage of the transition (if the activity is stage transition related). Valid values are:
     
     * `None`: The initial stage of a model version.
     
     * `Staging`: Staging or pre-production stage.
     
     * `Production`: Production stage.
     
     * `Archived`: Archived stage.
  - `system_comment` (string, optional)
    Comment made by system, for example explaining an activity of type `SYSTEM_TRANSITION`. It usually describes a side effect, such as a version being archived as part of another version's stage transition, and may not be returned for some activity types.
  - `available_actions` (array of string, optional)
    Array of actions on the activity allowed for the current viewer.
    Possible values: `APPROVE_TRANSITION_REQUEST`, `REJECT_TRANSITION_REQUEST`, `CANCEL_TRANSITION_REQUEST`, `EDIT_COMMENT`, `DELETE_COMMENT`
  - `id` (string, optional)
    Unique identifier for the object.
    Example: `6fc74c92704341aaa49e74dcc6031057`

## Response

```json
{
  "request": {
    "creation_timestamp": 1594437249910,
    "user_id": "jane.doe@example.com",
    "activity_type": "string",
    "comment": "This version is great!",
    "last_updated_timestamp": 1594437549910,
    "from_stage": "string",
    "to_stage": "string",
    "system_comment": "string",
    "available_actions": [
      "string"
    ],
    "id": "6fc74c92704341aaa49e74dcc6031057"
  }
}
```