BulkheadOS exposes a REST API that lets you manage your content programmatically. Use it to automate publishing, integrate with external tools, or build custom workflows.
Authentication
All administrative API requests require a scoped personal access token (PAT). Create one from Workspace Settings → Security → API Keys, choose content:read for read-only automation or content:write for create/update/archive workflows, and store it securely — the raw token is shown once.
The examples use BULKHEAD_SITE_URL for your workspace URL and BULKHEAD_API_TOKEN for the scoped token value.
curl -H "Authorization: Bearer $BULKHEAD_API_TOKEN" \
"$BULKHEAD_SITE_URL/api/v1/nodes"Tip: Automations and AI integrations should use the narrowest scopes possible instead of full admin access.
Base URL
$BULKHEAD_SITE_URL/api/v1/Rate Limits
API requests are rate-limited to protect the platform. Current limits:
| Endpoint | Limit |
|---|---|
Read operations (GET) | 100 requests/minute |
Write operations (POST/PATCH/DELETE) | 30 requests/minute |
When rate-limited, the API returns 429 Too Many Requests with a Retry-After header.