PayWeaveFiles
Collections
A collection groups related files together — like a folder with shared settings. Each collection has its own public ID, discovery settings, and contains one or more priced files.
Creating a Collection
From the dashboard, navigate to Files → Create Collection. You will configure:
| Field | Required | Description |
|---|---|---|
| Name | Yes | A human-readable label for the collection |
| Description | No | What this collection contains — shown in Bazaar discovery if published |
Collection lifecycle
Collections have three statuses:
| Status | Behavior |
|---|---|
| Active | Files are available for purchase and appear in discovery |
| Paused | Download requests are rejected but files remain in storage |
| Archived | Collection is disabled. Can be viewed but not reactivated |
Discovery
When a collection has discoverable enabled, its files appear in the Bazaar Discovery catalog. Agents and LLMs can find your files via /api/discovery/skills?type=file, /llms.txt, and the MCP server.
Each file in the collection becomes a discoverable endpoint with its download price, filename, content type, and file size exposed in the catalog.
Toggle discovery off in collection settings if you want to sell files only to users who already know the download URL.
API reference
Terminal
# List collections
GET /api/v1/files?mode=test
# Create collection
POST /api/v1/files?mode=test
{ "name": "ML Datasets", "description": "Training data" }
# Get collection detail
GET /api/v1/files/:id
# Update collection
PATCH /api/v1/files/:id
{ "name": "Updated Name", "discoverable": true }
# Archive collection
DELETE /api/v1/files/:id