Przejdź do treści
DarhimLabs Developers

DarhimLabs API

API Changelog

Semver changelog DarhimLabs API v2 z RSS, deprecations i migration guides.

API Changelog

Wszystkie zmiany w DarhimLabs API v2 publikujemy w modelu semver. Subskrybuj RSS, jesli chcesz automatycznie sledzic nowe endpointy, zmiany kontraktow i deprecations.

v2.4.0 - 2026-05-08

Added

  • POST /agents/{id}/dry-run/stream - Server-Sent Events stream dla ReAct steps. Nie musisz juz pollowac runa podczas dry-run.
  • Idempotency-Key dla wszystkich mutacji POST i PATCH. Retry po timeoutach nie zdubluje wiadomosci, leadow ani webhook endpointow.
  • /webhooks/playground/{token} - publiczny webhook inbox do testowania payloadow, headers i signature verification bez logowania.
  • GET /health - status modulow API v2: inbox, bots, voice, knowledge, webhooks i compliance.

Changed

  • GET /inbox/conversations - pole lead_score zwraca teraz obiekt { score: number, factors: string[] }. Poprzedni numeric shortcut jest wspierany do v3.0.
  • GET /webhooks/deliveries - delivery payload zawiera teraz next_retry_at, last_error i attempts_count.
  • Wszystkie response'y API v2 dostaja X-Request-ID, ktory mozna podac supportowi.

Deprecated

  • GET /agents/{id}/runs?include=postmortem - usuwamy w v3.0. Uzyj GET /agents/{id}/runs/{run_id}. Endpoint zwraca juz naglowki Sunset, Deprecation i Link.

Removed

  • Nic.

Security

  • Webhook signature verification wspiera timing-safe comparison w oficjalnych SDK: Node.js, Python i PHP.
  • Playground webhookow przechowuje zdarzenia maksymalnie 24h i nie wymaga autoryzacji.

v2.3.4 - 2026-04-22

Added

  • POST /webhooks/deliveries/{id}/replay - reczne ponowienie pojedynczego delivery z zachowaniem event_id.
  • GET /api-logs - live API logs dla workspace w dashboardzie developer settings.

Changed

  • Cursor pagination w list endpoints zwraca zawsze has_more i next_cursor.
  • Rate limit headers sa spójne dla REST API, sandboxa i webhook replay.

Fixed

  • POST /inbox/conversations/{id}/messages zwraca poprawny status 409 przy powtorzonym Idempotency-Key z innym payloadem.

v2.3.0 - 2026-04-10

Added

  • Oficjalny sandbox server https://api.darhimlabs.pl/api/v2-sandbox.
  • Pierwsza wersja SDK: @darhimlabs/node, darhimlabs dla Python i darhimlabs/php-sdk.
  • GET /webhooks/events jako machine-readable event catalog.

Changed

  • OAuth apps dostaly granularne scopes: read, write, admin.

v2.2.0 - 2026-03-18

Added

  • Publiczne endpointy Agents API: runs, approvals, dry-run i cancel.
  • POST /knowledge/search dla RAG search z citation metadata.

Deprecated

  • Offset pagination w v1. Pelna migracja do cursor pagination jest opisana w v1 to v2 guide.