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

# fal

> Connect fal to your workflows: 13 operations across 5 categories.

The fal node adds fal operations to your workflows. Add it on the canvas or ask the AI builder for it by name, then pick an operation and fill in its fields.

fal also includes 1 trigger operation (marked in the tables below) that can start a workflow when something happens in fal.

<Note>
  You can wire the fal node into an AI agent as a tool provider: the agent calls the operations you allow. See [Agent tools](/agents/tools).
</Note>

## Credentials

Connect fal under **Credentials** in the node settings. See [Connecting credentials](/credentials/connecting) for the general flow.

Enter the values manually when creating the credential.

[Get your credentials here](https://fal.ai/dashboard/keys).

## Operations

### Keys

| Operation          | ID           | Description                           | Trigger |
| ------------------ | ------------ | ------------------------------------- | ------- |
| **Create API Key** | `create_key` | Create a new API key for the account. |         |
| **Delete API Key** | `delete_key` | Delete an API key by its ID.          |         |
| **List API Keys**  | `list_keys`  | List all API keys for the account.    |         |

### Model run

| Operation              | ID               | Description                                                            | Trigger |
| ---------------------- | ---------------- | ---------------------------------------------------------------------- | ------- |
| **Cancel Request**     | `cancel_request` | Cancel a queued or in-progress request.                                |         |
| **Get Request Result** | `get_result`     | Fetch the completed result payload of a queued request.                |         |
| **Get Request Status** | `get_status`     | Poll the status of a queued request.                                   |         |
| **Run Model (Sync)**   | `run_model`      | Run a model endpoint synchronously and get the result inline.          |         |
| **Submit to Queue**    | `submit_queue`   | Submit an async request to the fal queue (best for long-running jobs). |         |

### Platform

| Operation                     | ID              | Description                                         | Trigger |
| ----------------------------- | --------------- | --------------------------------------------------- | ------- |
| **Get Usage**                 | `get_usage`     | Retrieve granular usage line items for the account. |         |
| **List Requests by Endpoint** | `list_requests` | List recent requests for a specific model endpoint. |         |
| **Search Models**             | `search_models` | Search and list available model endpoints.          |         |

### Storage

| Operation                | ID                | Description                                                          | Trigger |
| ------------------------ | ----------------- | -------------------------------------------------------------------- | ------- |
| **Initiate File Upload** | `initiate_upload` | Initiate a file upload to fal's CDN; returns a presigned upload URL. |         |

### Other

| Operation            | ID                 | Description                                                           | Trigger |
| -------------------- | ------------------ | --------------------------------------------------------------------- | ------- |
| **On Job Completed** | `on_job_completed` | Fire the workflow when a queued fal job completes (success or error). | Yes     |