Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hubify.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Backups API

The Backups API lets you trigger on-demand lab backups and query backup history. Backups are stored to Backblaze B2 by default. Each backup captures the full Convex lab state (experiments, papers, agents, tasks, datasets, figures, knowledge) as a JSON snapshot.

​
List Backups

​
labId
string
required
Convex ID of the lab.
curl "https://www.hubify.com/api/v1/backups?labId=$LAB_ID" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"
​
backups
object[]
required
Backup records, newest first.
​
stats
object
required
Lab-level backup statistics.

​
Create Backup

Triggers a new backup job. The job starts immediately; poll the list endpoint to track status.
​
labId
string
required
Convex ID of the lab to back up.
​
type
string
default:"checkpoint"
full (complete snapshot) or checkpoint (incremental since last full).
​
destination
string
default:"b2"
Storage destination. Currently b2 (Backblaze B2) is the only supported value.
curl -X POST https://www.hubify.com/api/v1/backups \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"labId":"$LAB_ID","type":"full"}'
​
id
string
required
New backup document ID.
​
type
string
required
Backup type as requested.
​
status
string
required
Initial status (running).