check_status
Check the status of a Fal.ai image generation request using its request ID to monitor progress and retrieve results.
Instructions
Check the status of a Fal.ai request
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request_id | Yes | The request ID to check |
Implementation Reference
- src/index.ts:421-434 (handler)Handler for the check_status tool. Parses input using CheckStatusSchema and returns a text response explaining that full status checking requires app_id and request_id, currently a stub implementation.
case "check_status": { const params = CheckStatusSchema.parse(args); // For now, return a message about status checking // Fal.ai queue.status requires both app_id and request_id return { content: [ { type: "text", text: "Status checking requires both app_id and request_id. Use the result from run_model or run_workflow which includes status information.", }, ], }; } - src/index.ts:83-85 (schema)Zod schema for check_status tool input validation: requires request_id string.
const CheckStatusSchema = z.object({ request_id: z.string().describe("The request ID to check status for"), }); - src/index.ts:192-205 (registration)Registration of the check_status tool in the list of tools returned by ListToolsRequestHandler, including name, description, and inputSchema matching the Zod schema.
{ name: "check_status", description: "Check the status of a Fal.ai request", inputSchema: { type: "object", properties: { request_id: { type: "string", description: "The request ID to check", }, }, required: ["request_id"], }, },