Cancel fal.ai Queue Request
fal_cancel_requestCancel a queued generative AI job before it begins processing, blocking it from running. Works only for requests still in queue.
Instructions
Cancel a queued request before it finishes processing. Only works while status is IN_QUEUE — requests already IN_PROGRESS or COMPLETED cannot be cancelled and this will return an error.
Args:
model_id (string): The same model id used when submitting, e.g. "fal-ai/minimax/video-01"
request_id (string): The request_id returned by fal_submit_request
Returns: A confirmation message once the cancellation is accepted.
Examples:
Use when: "Actually, cancel that video job I just started" -> cancel while still IN_QUEUE
Don't use when: the job is already IN_PROGRESS or COMPLETED (use fal_check_status to confirm first)
Error Handling:
Returns "Not found (404)" if the request_id is wrong
Returns an error if the request already started processing or completed (cannot be cancelled)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"model_id": "<model_id>",
"request_id": "<request_id>"
},
"name": "fal_cancel_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model_id | Yes | The fal.ai model/endpoint id, e.g. "fal-ai/flux/dev", "fal-ai/flux-pro/kontext", or "fal-ai/minimax/video-01". Find valid ids with fal_list_models or at https://fal.ai/models. | |
| request_id | Yes | The request_id returned by fal_submit_request when the job was queued. |