FAfal
Serverless
Runners

Stop Runner

Gracefully stops a serverless runner owned by the authenticated account. The runner stops accepting new requests and finishes in-flight work before shutting down.

Set replace_first=true to start a replacement before stopping this runner. This option applies to deployed application runners, not standalone fal run runners.

A successful response acknowledges the stop request; the runner may still be draining. Stopping a runner does not change the application's scaling configuration, so autoscaling may start new runners.

Required permissions: serverless:runners:terminate. Key presets that include them: COMPUTE, FULL. See key permissions.

post/serverless/runners/{runner_id}/stop

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/serverless/runners/{runner_id}/stop
  • Auth
    API key in header Authorization

Path parameters

runner_idstring required

ID of the serverless runner to stop

Example:f1e2d3c4-b5a6-7890-dcba-0987654321fe

Query parameters

replace_first'true' | 'false'

Whether to start a replacement runner before stopping this one. Defaults to false.

Example:false

Response

Graceful stop requested successfully

runner_idstring required

ID of the runner whose graceful stop was requested

Example response

{
  "runner_id": "f1e2d3c4-b5a6-7890-dcba-0987654321fe"
}

Changes