pb-api

PocketBase API

Reference: https://pocketbase.io/docs/

Operate PocketBase via its REST API.

Credentials

Create .env from .env.example (never commit .env):

PB_URL=http://localhost:8090
[email protected]
PB_SUPERUSER_PASSWORD=your-password

If credentials aren't available via env vars, ask user explicitly before proceeding.

Quick Start

# Auth
curl -X POST http://localhost:8090/api/collections/_superusers/auth \
  -H 'Content-Type: application/json' \
  -d '{"identity":"[email protected]","password":"secret"}'

# List records
curl http://localhost:8090/api/collections/posts/records \
  -H 'Authorization: Bearer TOKEN'

# Filter records
curl "http://localhost:8090/api/collections/posts/records?filter=status='published'&sort=-created&expand=author"

Key Endpoints

Filter Syntax

status = 'published'
author.id = 'abc123'
created >= '2024-01-01'
user.name ~ 'john*'

Use @collection.name.field for cross-collection filters.

SDK Usage

import PocketBase from 'pocketbase'

const pb = new PocketBase('http://localhost:8090')
await pb.collection('posts').authWithPassword('[email protected]', 'secret')

// List with filter
const records = await pb.collection('posts').getList(1, 50, {
  filter: "status = 'published'",
  sort: '-created',
  expand: 'author,tags'
})

API Rules

• null → superuser only
• "" → public access
• Start locked, open selectively
• Use @request.auth, @collection, @now in rules