Events

Every event you can listen to, with its data fields

Required scope: automations:read

Self-describing: each type carries label, group and fields (the keys its data holds). ?type= returns one type; ?group= narrows.

Authorization

bearerAuth

AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

`application/json`

{}

Pull events (the feed), oldest first, after a cursor

Required scope: automations:read

The space keeps an event while some listener wants its type, for 14 days. Pass the answer's next_cursor as after on the next call; has_more says whether to call again at once. subscription_id narrows to one feed's types and filters.

Authorization

bearerAuth

AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Query Parameters

after?string

A cursor (evt_…)

types?string

Comma-separated event types

subscription_id?string

limit?integer

Response Body

`application/json`

{}

List listeners (webhooks, feeds, agents) with 24-hour delivery counts

Required scope: automations:read

Authorization

bearerAuth

AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Query Parameters

kind?string

Response Body

`application/json`

{}

Create a webhook or a feed

Required scope: automations:write

kind: "webhook" — we POST each event to your https url, signed: Wakato-Signature: t=<unix seconds>,v1=<hex>, v1 = HMAC-SHA256(secret, "."). The secret is in this response ONCE (rotate it with /rotate-secret). Failed deliveries are retried with backoff; a URL that keeps failing is switched off, saying why. kind: "feed" — the events are kept for you to pull with GET /events. kind: "agent" is only for an agent's own key (its events arrive in its chat). filters take the automation trigger's own config per event type.