Bulkhead OS 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 only the scopes you need, and store it securely — the raw token is shown once.
curl -H "Authorization: Bearer YOUR_PAT" \
https://your-domain.com/api/admin/nodesTip: Automations and MCP/AI agents should use the narrowest scopes possible instead of full admin access.
Base URL
https://your-domain.com/api/admin/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.