reference
Insert, Update, Upsert & Pagination
Write rows, upsert on conflict, delete, single-row helpers, and paginate results.
Published: September 6, 2026Updated: September 6, 2026
Insert
const { data, error } = await postbase
.from('posts')
.insert({ title: 'Hello World', status: 'draft' })
.select()
.single()Update
const { data, error } = await postbase
.from('posts')
.update({ status: 'published' })
.eq('id', 'post-id')
.select()
.single()Upsert
const { data, error } = await postbase
.from('profiles')
.upsert({ id: 'user-id', username: 'alice' }, { onConflict: 'id' })
.select()Delete
const { error } = await postbase
.from('posts')
.delete()
.eq('id', 'post-id')Single Row Helpers
// Errors if not exactly one row
const { data, error } = await postbase.from('posts').select('*').eq('id', id).single()
// Returns null if not found (no error)
const { data } = await postbase.from('posts').select('*').eq('id', id).maybeSingle()Pagination
// Limit + offset
const { data } = await postbase.from('posts').select('*').limit(20).offset(40)
// Range (inclusive)
const { data } = await postbase.from('posts').select('*').range(0, 19)Get Total Count
const { data, count } = await postbase
.from('posts')
.select('*', { count: 'exact' })