# Async requests

{% hint style="warning" %}
You need to be subscribed to the [Webhooks](/getting-started/webhooks.md) to receive updates resources or fields.
{% endhint %}

## Triggering a FlowRun

To trigger a [FlowRun](/resources/api-resource-reference/flowrun.md) a post request to `/flow-runs` with the [MessageThread](/resources/api-resource-reference/messagethread.md) and a [Flow](/resources/api-resource-reference/flow.md) is required. Once created you will receive the created FlowRun with the status `created`. All further updates will be done via [Webhooks](/getting-started/webhooks.md).

Once created we will instantaneously try to start the FlowRun and send you an update of the changed status of the FlowRun to `running` once the status changes again to `finished`, `timeout` or `exception` you will get a new notification.

The `state` attribute will contain data gathered during the flow.

Visualized it looks like this:

<figure><img src="/files/stFKyZqX1E9aY4NXbf9j" alt=""><figcaption></figcaption></figure>

## Generating a "vacancy\_application\_flow"

Triggering a [FlowGeneration](/resources/api-resource-reference/flowgeneration.md) follows a similar path, in this example we will visualize the creation of a [vacancy\_application\_flow](/resources/flow-types/vacancy_application_flow.md).

As input for the FlowGeneration, you can optionally use the [VacancyAnalysis](/resources/api-resource-reference/vacancyanalysis.md), after that POST to `/flow-generations`. All further updates will be done via [Webhooks](/getting-started/webhooks.md).

<figure><img src="/files/5Bn9HJYrP3nRCQOR7jSz" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.recrubo.app/getting-started/async-requests.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.