Open · OpenAPI 3.0
BetaOS API
Integriere BetaOS in deine bestehende Tool-Landschaft.
Jede Entität in BetaOS – Zellen, Rollen, Services, Ziele, Mitarbeiter:innen – ist über eine stabile RESTful-API verfügbar. Nutze sie, um bestehende Systeme anzubinden, Workflows zu automatisieren oder komplett neue Anwendungen auf dem BetaOS-Betriebsmodell zu bauen.
BetaOS API v1
OpenAPI 3.0 GET /v1/cells Cells
POST /v1/cells Cells
GET /v1/cells/{id} Cells
GET /v1/roles Roles
PUT /v1/roles/{id} Roles
POST /v1/services Services
GET /v1/targets Targets
PATCH /v1/targets/{id} Targets
GET /v1/economic-buyers Buyers
POST /v1/webhooks Webhooks
Authorization: Bearer bos_live_e7a9c…f3b1 scoped
POST /v1/cells
"name": "Enterprise",
"kind": "periphery",
"buyer": "market"
201 Created application/json
{
"id": "cell_4d9f",
"name": "Enterprise",
"kind": "periphery",
"buyer": "market",
"created_at": "2026-05-19T08:42Z"
}
Überblick
Die API ist vollständig nach OpenAPI 3.0 dokumentiert, inklusive interaktiver Beispiele und SDK-freundlicher Response-Shapes. Sie ist offen by design: keine künstlichen Beschränkungen, kein Vendor-Lock-in, keine separate Enterprise-Stufe für Basisfunktionen. Unternehmen, Entwickler:innen, Forschende und Berater:innen bauen auf demselben stabilen Vertrag.
Funktionen im Überblick
- RESTful-Endpoints für jede BetaOS-Entität
- OpenAPI-3.0-Spezifikation mit interaktiver Dokumentation
- Token-basierte Authentifizierung mit rollenbezogenen Scopes
- Webhooks für Entity-Change-Events
- Großzügige Rate-Limits mit transparenten Kontingenten
- Rückwärtskompatible Versionierungspolitik
Anwendungsfälle
- Synchronisation von Teams und Rollen zwischen BetaOS und Personio/Workday
- Strukturänderungen aus BetaOS in Slack oder Confluence pushen
- Eigene Visualisierungen und Reports bauen
- Onboarding-Workflows automatisieren, ausgelöst durch Rollenzuweisungen