Bleenk exposes a REST API for programmatic access. Use it to start agent runs, query session status, manage projects, and subscribe to workspace events from CI or internal tools.
Authentication
Create a workspace API token under Settings. Send it as a Bearer token on every request.
bash
curl https://api.bleenk.app/v1/projects \
-H "Authorization: Bearer YOUR_TOKEN"Common endpoints
- POST /v1/projects — create a project
- GET /v1/projects/{id}/sessions — list agent sessions
- POST /v1/sessions/{id}/messages — send a message and start or continue a run
- POST /v1/projects/{id}/deploy — trigger a deploy for a configured target
- GET /v1/workspaces/{id}/events — SSE stream for run and deploy updates
OpenAPI
Your workspace admin can download the full OpenAPI spec from Settings → API. Schemas match what the cloud app uses internally.
Webhooks
Register webhook URLs to receive run.completed, deploy.succeeded, and approval.required events. Verify signatures with the signing secret shown at creation time.