Update Vault Properties — Prompt Bank API Reference

Update one or more properties of an existing vault you own. This endpoint uses partial update semantics — you only need to include the fields you want to change, and all other properties remain untouched. For example, you can rename a vault without affecting its visibility or description, or flip a private vault to public in a single targeted request.

Endpoint

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

Path Parameters

integer

required

The numeric ID of the vault to update.

Body Parameters

All body parameters are optional. Include only the fields you want to update.

string

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

string | null

A new description for the vault. Maximum 200 characters. Pass null to clear an existing description.

string

The new visibility setting. Accepted values are private, unlisted, or public.

Request Example

This example updates only the visibility of vault 7, leaving its name and description unchanged.

curl -X PATCH https://www.promptbank.club/api/v1/vaults/7 \
  -H 'Authorization: Bearer pb_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "visibility": "public"
  }'

Response Example

A 200 OK response is returned on success. The data field contains the complete updated 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": 12,
    "createdAt": "2024-05-01T10:00:00Z",
    "updatedAt": "2024-05-16T14:22:00Z"
  },
  "error": null
}

⌘I

Overview

Prompts

Vaults

Generations

Uploads

API Keys

Update Vault Properties — Prompt Bank API Reference

Endpoint

Path Parameters

Body Parameters

Request Example

Response Example

​Endpoint

​Path Parameters

​Body Parameters

​Request Example

​Response Example

Endpoint

Path Parameters

Body Parameters

Request Example

Response Example