Kiket docsAPI & SDKs
Evidence adapters
Install and build evidence connectors on the platform ingestion model.
Start here: Build your first evidence adapter.
Evidence adapters normalize external systems into Kiket's raw inbox and evidence graph. They use scoped API keys and /platform/* routes — not the removed legacy /extensions webhook catalog.
Platform surfaces
| Surface | Purpose |
|---|---|
POST /platform/raw-events | Idempotent raw inbox ingest |
POST /platform/raw-events/{rawEventId}/submit | Runner submits normalization (raw-events:submit) |
POST /platform/evidence | Normalized evidence records |
POST /platform/extensions | Install adapter; returns runnerApiKey once (owner/admin) |
GET /platform/extensions/{id}/runtime | Last dispatch/claim/submit and last runtime error |
GET /platform/raw-events/claim | Pull transport: lease dispatch envelopes (raw-events:claim) |
POST /platform/event-sources | Bind ingress (webhook URL, source key) |
POST /platform/credentials | Sealed secrets (owner/admin) |
GET /platform/extension-ingestion/contract | Machine-readable adapter contract |
POST /platform/marketplace/listings | Publish kiket-extension.yaml to the registry (owner/admin) |
GET /platform/marketplace/listings | List public + org-private published listings |
GET /platform/marketplace/catalog | Merged catalog (same data as /platform/extensions/catalog) |
Authoring tools
kiket extension init— scaffoldkiket-extension.yaml+ starter adapterkiket extension validate— validate manifest locallykiket extension test— POST a fixture raw event using API-key authkiket extension install— install with--transport catalog_hosted|push|pulland optional--endpoint-urlkiket extension run— local runner for push (--transport push) or pull polling (--transport pull)kiket extension publish— submit a manifest to the marketplace registry (--visibility public|org,--git-urlor--publisher-contact)@kiket-dev/sdk— manifest Zod schema +createIngestionClient()
Legacy note
Older docs described outbound Kiket→extension webhooks with issue/comment scopes. That model is retired. New connectors are ingress adapters that call the platform API using the Kiket SDK.