GET /api/v1/vaults/{vaultId}/prompts — List Vault Prompts - Prompt Bank

Retrieve all prompts currently inside a specific vault. Results are ordered so that pinned prompts appear first, followed by the remaining prompts sorted by the date they were added to the vault, newest first. This ordering mirrors how prompts appear in the Prompt Bank UI.

Endpoint

GET https://www.promptbank.club/api/v1/vaults/{vaultId}/prompts

Path Parameters

integer

required

The numeric ID of the vault whose prompts you want to list.

Request Example

curl https://www.promptbank.club/api/v1/vaults/7/prompts \
  -H 'Authorization: Bearer pb_live_...'

Response Example

The data field contains an array of prompt objects. Pinned prompts (isPinned: true) appear at the top of the list.

{
  "data": [
    {
      "id": 101,
      "vaultPromptId": 55,
      "title": "Golden Hour Portrait",
      "prompt": "A warm golden hour portrait of a woman standing in a field of wheat, soft bokeh background, film grain, Kodak Portra 400",
      "promptType": "image",
      "platform": "fal",
      "status": "active",
      "images": [],
      "vaultIds": [7],
      "isPinned": true,
      "createdAt": "2024-05-02T12:00:00Z",
      "updatedAt": "2024-05-10T08:00:00Z"
    },
    {
      "id": 108,
      "vaultPromptId": 61,
      "title": "Studio Lighting Close-Up",
      "prompt": "Close-up portrait with dramatic studio lighting, deep shadows, high contrast, black and white, sharp focus on eyes",
      "promptType": "image",
      "platform": "fal",
      "status": "active",
      "images": [],
      "vaultIds": [7],
      "isPinned": false,
      "createdAt": "2024-05-12T15:30:00Z",
      "updatedAt": "2024-05-12T15:30:00Z"
    }
  ],
  "error": null
}

Prompt Object Fields

Field	Type	Description
`id`	integer	The unique ID of the prompt record.
`vaultPromptId`	integer	The unique ID of the vault–prompt membership record. Used when removing, moving, or pinning the prompt within this vault.
`title`	string	The prompt’s display title.
`prompt`	string	The full text content of the prompt.
`promptType`	string	One of `image`, `text`, or `video`.
`platform`	string \| null	The platform or service this prompt targets, if set.
`status`	string	The current status of the prompt (e.g. `active`).
`images`	array	Image outputs generated from this prompt, if any.
`vaultIds`	array of integers	IDs of all vaults this prompt belongs to.
`isPinned`	boolean	Whether the prompt is pinned to the top of this vault.
`createdAt`	string	ISO 8601 timestamp when the prompt was created.
`updatedAt`	string	ISO 8601 timestamp of the last modification.