> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a routine run

> Start an on-demand run for a routine.

Create a routine run through the authenticated API. The endpoint creates and
returns a [Routine run object](/reference/routines/run-object) immediately while
routine execution continues asynchronously.

Use an `Idempotency-Key` header when retrying create-run requests. See
[Idempotency](/reference/idempotency).

### Parameters

<ParamField path="routine_id" type="string" required>
  ID of the routine.
</ParamField>

### Returns

Returns a [Routine run object](/reference/routines/run-object).