Create a New Vault — Prompt Bank REST API Reference

Create a new vault to organize your prompts into a focused, shareable collection. You control who can see the vault by setting its visibility — keep it private for personal use, share a link with unlisted, or make it fully public for anyone to discover and fork. A successful request returns the newly created vault object with a 201 Created status.

Endpoint

POST https://www.promptbank.club/api/v1/vaults

Body Parameters

string

required

The display name for the vault. Must be between 1 and 50 characters.

string | null

An optional description of the vault’s contents or purpose. Maximum 200 characters. Pass null or omit to leave it blank.

string

default:"private"

Controls who can access the vault. Accepted values are private (only you), unlisted (anyone with the link), or public (discoverable by all users). Defaults to private if omitted.

Request Example

curl -X POST https://www.promptbank.club/api/v1/vaults \
  -H 'Authorization: Bearer pb_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Portrait Prompts",
    "description": "Curated prompts for portrait photography and art",
    "visibility": "public"
  }'

Response Example

A 201 Created response is returned on success. The data field contains the full vault object.

{
  "data": {
    "id": 7,
    "name": "Portrait Prompts",
    "description": "Curated prompts for portrait photography and art",
    "slug": "portrait-prompts",
    "visibility": "public",
    "accessType": null,
    "isLocked": false,
    "coverImageUrl": null,
    "isSystem": false,
    "promptCount": 0,
    "createdAt": "2024-05-01T10:00:00Z",
    "updatedAt": "2024-05-01T10:00:00Z"
  },
  "error": null
}

Overview

Prompts

Vaults

Generations

Uploads

API Keys

Create a New Vault — Prompt Bank REST API Reference

Endpoint

Body Parameters

Request Example

Response Example

​Endpoint

​Body Parameters

​Request Example

​Response Example

Endpoint

Body Parameters

Request Example

Response Example