# Generate or update a flow

**POST /flows**




## Servers



## Parameters


### Query parameters
- **format** (string)
  The desired format for the generated flow
- **output-mode** (string)
  Whether to produce an incremental flow (excluding the existing flow) or a full flow

### Body:  (object)

- **text** (string)
  The text description of the flow we should generate
- **context** (string)
  The broader context that should be used to interpret `text`.

  For example, if a user writes:

  ```
  After users log in, bring them to the home page
  ```

  and then continues:

  ```
  Then, if it's their first visit, show them a popup
  ```

  Providing `After users log in...` as context when passing
  `Then, ...` as the text will result in the correct interpretation
  of the source state for showing the popup.

  The context will not contribute to any new transitions.
  It will only be used to properly interpret `text`.
- **existingFlow** (object)



## Responses
### 200
The requested flow

#### Body:  (object)
- **id** (string)
  Response identifier to be used in error reporting, debugging, and feedback
- **result** (object)



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