Omnika Public API

Programmatischer Zugriff auf Workspaces, Workshops, Sprints, Docs und Chat.

In Vorbereitung — Public API kommt mit V10 (Q3 2026)

Was du heute schon nutzen kannst

Aktuell ist die Nika-MCP-Bridge der einzige Weg, Omnika programmatisch anzusprechen. Über AI-Tool-Calls in Nika kannst du Workspaces lesen, Messages schreiben, Tasks anlegen und Workshops bedienen — alles ohne separates API-Token. Sobald die Public REST-API live ist, bleiben beide Wege parallel verfügbar.

Nika-MCP-Plugins ansehen →

Authentication (preview)

Jeder API-Request authentifiziert sich über einen Personal Access Token (PAT) im Authorization: Bearer <pat> Header. Tokens kannst du ab V10 unter Einstellungen → Sicherheit erstellen — pro Token werden Scopes (read/write) und Ablauf-Datum gesetzt.

GET /api/v1/workspaces
Host: hub.omnika.team
Authorization: Bearer <PAT>
Accept: application/json

Geplante Endpoints

Sechs Endpoint-Gruppen, eine pro Produkt-Fläche. Methods, Pfade und Reihenfolge sind Teil des dokumentierten Vertrags.

Workspaces

  • GET/api/v1/workspacesListe der Workspaces, auf die das PAT Zugriff hat.
  • GET/api/v1/workspaces/:idWorkspace-Details inkl. Member-Count und Plan.
  • POST/api/v1/workspacesNeuen Workspace erstellen (nur für Owner-Accounts).

Channels

  • GET/api/v1/channelsListe der Channels, filterbar via ?workspace=…
  • POST/api/v1/channelsNeuen Channel in einem Workspace erstellen.
  • GET/api/v1/channels/:id/messagesMessage-History eines Channels (paginiert).
  • POST/api/v1/channels/:id/messagesNeue Message in einem Channel senden.

Workshops (Whiteboard)

  • GET/api/v1/workshopsListe der Whiteboards eines Workspaces.
  • POST/api/v1/workshopsNeues Workshop-Board anlegen.
  • GET/api/v1/workshops/:id/stickiesAlle Sticky-Notes eines Workshops abrufen.
  • POST/api/v1/workshops/:id/stickiesNeue Sticky-Note hinzufügen.

Sprints

  • GET/api/v1/sprintsListe der Sprints eines Workspaces.
  • POST/api/v1/sprintsNeuen Sprint erstellen (mit Zeitraum + Ziel).
  • GET/api/v1/sprints/:id/tasksTasks eines Sprints inkl. Status.
  • POST/api/v1/sprints/:id/tasksNeue Task einem Sprint hinzufügen.

Docs

  • GET/api/v1/docsListe der Docs eines Workspaces.
  • POST/api/v1/docsNeues Doc anlegen (leer oder aus Template).
  • GET/api/v1/docs/:id/blocksAlle Blöcke eines Docs abrufen (Reihenfolge erhalten).
  • PATCH/api/v1/docs/:id/blocks/:blockIdEinzelnen Block aktualisieren (Inhalt oder Typ).

Webhooks (für deine Integrationen)

  • POST/api/v1/webhooksWebhook abonnieren — Events an deine URL pushen.
  • DELETE/api/v1/webhooks/:idWebhook-Subscription wieder beenden.
  • GET/api/v1/webhooksListe deiner aktiven Webhook-Subscriptions.

Rate-Limits

  • 1000 req/h pro Personal Access Token
  • 5000 req/h pro Workspace (über alle Tokens summiert)
  • Burst-Erlaubnis: 50 req/min Spikes sind ok, danach greift Token-Bucket

Jede Response trägt die Header X-RateLimit-Remaining und X-RateLimit-Reset — bei Überschreitung kommt HTTP 429.

Webhooks (preview)

Mit V10 kannst du HTTP-Webhooks für Events abonnieren — etwa message.created, workshop.updated oder task.completed. Jeder Event wird als JSON-POST an deine URL gepusht, signiert mit einem HMAC-SHA256-Header zur Verifikation.

{
  "event": "message.created",
  "workspace_id": "ws_a1b2c3",
  "channel_id": "ch_42",
  "occurred_at": "2026-09-14T10:23:45Z",
  "data": {
    "id": "msg_8731",
    "author_id": "usr_91",
    "text": "Sprint-Review heute um 16 Uhr.",
    "thread_root_id": null
  }
}

Bleib auf dem Laufenden

Wir teilen API-Updates, Breaking-Changes und Release-Termine über unseren Changelog. Feature-Requests oder Beta-Anfragen gerne direkt per Mail.

Updates im ChangelogFeature-Request senden →

← Zurück zu /marketing