# Prompt Bank

- [Prompt Bank: AI Prompt & Vault Management Overview](https://docs.promptbank.club/introduction.md): Prompt Bank is a REST API for storing, organizing, and running AI generations. Learn what prompts, vaults, and generations are and how they work together.
- [Prompt Bank Quick Start: Your First API Call in 5 Minutes](https://docs.promptbank.club/quickstart.md): Create your first prompt and queue an AI image generation with Prompt Bank. Covers API key setup, creating a prompt, and triggering a generation.
- [API Authentication: Bearer Tokens & Keys | Prompt Bank](https://docs.promptbank.club/authentication.md): All Prompt Bank API requests use Bearer token authentication. Learn how to create API keys, pass them in requests, and handle authentication errors.
- [Prompts: Reusable AI Instructions in Prompt Bank](https://docs.promptbank.club/concepts/prompts.md): Prompts are the core unit in Prompt Bank. Learn about prompt types (text, image, video), fields like modelId and aspectRatio, and how prompts connect to vaults.
- [Vaults: Organize and Share Your Prompt Collections](https://docs.promptbank.club/concepts/vaults.md): Vaults are collections of prompts in Prompt Bank. Learn about vault visibility settings, forking, pinning prompts, and how to organize your prompt library.
- [AI Generations: Queue and Save Media with Prompt Bank](https://docs.promptbank.club/concepts/generations.md): Generations let you queue AI image and video creation through the Prompt Bank API. Learn the async generation flow, supported models, and how outputs are saved to vaults.
- [Create and Manage Prompts via the Prompt Bank API](https://docs.promptbank.club/guides/manage-prompts.md): Step-by-step guide to creating, updating, filtering, and deleting prompts with the Prompt Bank API. Includes pagination and vault filtering examples.
- [Organize Prompts into Vaults in Prompt Bank](https://docs.promptbank.club/guides/organize-vaults.md): Learn how to create vaults, set visibility, add and move prompts, fork public vaults, and pin your favorite prompts using the Prompt Bank API.
- [Generate AI Images and Videos with Prompt Bank](https://docs.promptbank.club/guides/generate-media.md): Learn how to queue AI image and video generations, use image inputs for img2img, set aspect ratios and batch counts, and retrieve outputs from your vault.
- [Upload Reference Images for Prompts and Generations](https://docs.promptbank.club/guides/upload-images.md): Learn how to upload PNG, JPEG, WebP, and GIF images to Prompt Bank for use as prompt images or generation inputs. Covers the two-step signed upload flow.
- [Prompt Bank REST API Overview and Base URL](https://docs.promptbank.club/api-reference/overview.md): Overview of the Prompt Bank REST API. Covers base URL, versioning, request format, the { data, error } response envelope, and pagination.
- [API Key Authentication for the Prompt Bank API](https://docs.promptbank.club/api-reference/authentication.md): Prompt Bank uses Bearer token authentication. Pass your API key in the Authorization header on every request. Learn how to create and manage API keys.
- [Prompt Bank API Error Codes and Troubleshooting](https://docs.promptbank.club/api-reference/errors.md): Reference for Prompt Bank API error responses. Covers HTTP status codes 400, 401, and 404, the error response format, and how to handle each error type.
- [List Prompts — GET /api/v1/prompts | Prompt Bank](https://docs.promptbank.club/api-reference/prompts/list.md): Retrieve a paginated list of your prompts. Filter by vault or type, and use cursor-based pagination to walk through large collections efficiently.
- [Create Prompt — POST /api/v1/prompts | Prompt Bank](https://docs.promptbank.club/api-reference/prompts/create.md): Create a text, image, or video prompt. Requires a title and prompt text. For image and video types, a valid fal-ai/ modelId is also required.
- [Retrieve a Prompt — GET /api/v1/prompts/{promptId}](https://docs.promptbank.club/api-reference/prompts/get.md): Retrieve a single prompt by its numeric ID. Returns the full prompt object including title, prompt text, type, status, images, and vault memberships.
- [Update Prompt — PATCH /api/v1/prompts/{promptId}](https://docs.promptbank.club/api-reference/prompts/update.md): Partially update a prompt with PATCH. Send only the fields you want to change — omitted fields stay untouched. Returns the full updated prompt object.
- [Delete Prompt — DELETE /api/v1/prompts/{promptId}](https://docs.promptbank.club/api-reference/prompts/delete.md): Permanently delete a prompt by ID. Removes it from all vaults it belongs to. Deletion is irreversible — there is no way to recover a deleted prompt.
- [Save Prompt to Vault — POST /api/v1/prompts/{id}/save](https://docs.promptbank.club/api-reference/prompts/save-to-vault.md): Add an existing prompt to a vault by vault ID. A prompt can belong to many vaults at once — saving to a new vault never removes it from existing vaults.
- [GET /api/v1/vaults — Retrieve All Your Prompt Vaults](https://docs.promptbank.club/api-reference/vaults/list.md): GET /api/v1/vaults — retrieve all vaults owned by the authenticated user, including system vaults. Returns an array of vault objects.
- [Create a New Vault — Prompt Bank REST API Reference](https://docs.promptbank.club/api-reference/vaults/create.md): POST /api/v1/vaults — create a new vault to organize prompts. Set a name, optional description, and visibility (private, unlisted, or public).
- [Retrieve a Single Vault — Prompt Bank API Reference](https://docs.promptbank.club/api-reference/vaults/get.md): GET /api/v1/vaults/{vaultId} — fetch a single vault by its numeric ID. Returns vault details including visibility, prompt count, and system status.
- [Update Vault Properties — Prompt Bank API Reference](https://docs.promptbank.club/api-reference/vaults/update.md): PATCH /api/v1/vaults/{vaultId} — update a vault's name, description, or visibility. All fields are optional; send only the properties you want to change.
- [DELETE /api/v1/vaults/{vaultId} — Delete Your Vault](https://docs.promptbank.club/api-reference/vaults/delete.md): DELETE /api/v1/vaults/{vaultId} — permanently delete a vault by ID. Prompts inside the vault are not deleted, only removed from the vault.
- [Fork an Existing Vault — Prompt Bank API Reference](https://docs.promptbank.club/api-reference/vaults/fork.md): POST /api/v1/vaults/{vaultId}/fork — copy a public or unlisted vault and all its prompts into your account. Returns the new forked vault object.
- [GET /api/v1/vaults/{vaultId}/prompts — List Vault Prompts](https://docs.promptbank.club/api-reference/vaults/list-prompts.md): GET /api/v1/vaults/{vaultId}/prompts — list all prompts inside a specific vault. Returns prompt objects ordered by pin status and creation date.
- [POST /api/v1/vaults/{vaultId}/prompts — Add Prompts](https://docs.promptbank.club/api-reference/vaults/add-prompts.md): POST /api/v1/vaults/{vaultId}/prompts — add up to 50 existing prompts to a vault in a single request by passing an array of prompt IDs.
- [DELETE Vault Prompt — Remove a Prompt from a Vault](https://docs.promptbank.club/api-reference/vaults/remove-prompt.md): DELETE /api/v1/vaults/{vaultId}/prompts/{vaultPromptId} — remove a prompt from a vault. The prompt record itself is not deleted from your account.
- [Move a Vault Prompt to Another Vault — Prompt Bank API](https://docs.promptbank.club/api-reference/vaults/move-prompt.md): Move a prompt from one vault to another you own. POST /api/v1/vaults/{vaultId}/prompts/{vaultPromptId}/move — supply targetVaultId in the request body.
- [Pin and Unpin Prompts in a Vault — Prompt Bank API](https://docs.promptbank.club/api-reference/vaults/pin-prompt.md): Pin or unpin any prompt in a vault to control its listing order. POST pins the prompt to the top; DELETE removes the pin. Both return 200 OK.
- [POST /api/v1/generations — Queue an AI Generation](https://docs.promptbank.club/api-reference/generations/queue.md): POST /api/v1/generations — queue an AI image or video generation. Requires prompts:write scope. Output is saved asynchronously to a vault.
- [POST /api/v1/uploads/images — Upload a Prompt Image](https://docs.promptbank.club/api-reference/uploads/images.md): POST /api/v1/uploads/images — request a signed upload URL for PNG, JPEG, WebP, or GIF up to 10 MB, then PUT bytes directly to storage.
- [GET /api/v1/api-keys — List All API Keys for Your Account](https://docs.promptbank.club/api-reference/api-keys/list.md): GET /api/v1/api-keys — list all API keys for your account. Browser session required. Returns metadata only — never the raw key values.
- [POST /api/v1/api-keys — Create a New Prompt Bank API Key](https://docs.promptbank.club/api-reference/api-keys/create.md): POST /api/v1/api-keys — create a new API key for your account. Browser session required. The raw key is returned once and cannot be retrieved again.
- [GET /api/v1/api-keys/{keyId} — Reveal an API Key](https://docs.promptbank.club/api-reference/api-keys/reveal.md): GET /api/v1/api-keys/{keyId} — retrieve the stored secret for an API key you own. Browser session required. Never log or publish this response.
- [DELETE /api/v1/api-keys/{keyId} — Revoke an API Key](https://docs.promptbank.club/api-reference/api-keys/revoke.md): DELETE /api/v1/api-keys/{keyId} — permanently revoke an API key so it can no longer authenticate requests. Browser session required.