API Overview
The Opbox API lets you read and manage everything in your workspace - organisations, workspaces, members, forms, submissions, tables, matters, documents, automations, pipelines, tasks, invoices, files, and more. Resources are scoped to workspaces within organisations. All API access requires authentication via API keys.
Quick Start
1. Create an API Key
Go to Settings -> API Keys and create a new key. Copy it immediately - you won't be able to see it again.
2. Make Your First Request
Include your API key in the Authorization header:
curl -H "Authorization: Bearer sk_your_api_key" \
https://your-domain.com/api/forms
3. Explore the API
Browse the resource reference below for every endpoint group.
Base URL
All API requests should be made to your Opbox instance:
https://your-domain.com/api
Response Format
All responses are JSON. Successful responses include the requested data. New and migrated endpoints return a standardised error envelope:
// Success
{
"forms": [...],
"success": true
}
// Error (new standard)
{
"success": false,
"error": "Unauthorized",
"code": "UNAUTHORIZED",
"details": {}
}
Some older endpoints may still use a simpler { "error": "..." } format while migration is in progress.
Resources
- Authentication - API keys, headers, and security
- Organisations - Orgs, workspaces, and members
- Forms - Forms, submissions, and tables
- Submissions - Submission lifecycle and snapshots
- Tables - Data tables, views, and records
- Matters - Cases, steps, and lifecycle
- Documents - Knowledge base pages and articles
- Workflows - Durable workflow runs and steps
- Automations - Triggered automations and rules
- Dashboards - Widgets, charts, and date-range filtering
- Pipelines - External data connectors and syncs
- Integrations - Email providers and third-party links
- Notifications - Events, followers, and preferences
- Themes - Custom themes and design tokens
- Addons - Modular addon install and lifecycle
- AI Assistant - Chat, tools, and streaming
- Accounting - Invoices, stats, and accounting sync
- Audit Log - Audit trail and retention
- SSO & SCIM - Enterprise SSO, SCIM provisioning, and audit retention
- CSP Intelligence - Ownership graphs, registers, and compliance
- Files & Upload - File uploads, storage, and search
- Tasks - Unified task list and bulk actions
- Intelligence - Document extraction and identity resolution
- Errors & Limits - Status codes and rate limiting
- Opbox Sign - Native e-signature envelopes and audit trail
- Billing - Subscriptions, invoices, and usage
- Agent Tasks - Autonomous task queue and bridge
- All Endpoints - Complete machine-generated endpoint list