GET /api/chain/{slug}/events
Read-only feed over contract_events for one slug.
Filterable by event name + a since_zeqond watermark + a limit. Auth-gated by canRead so only the machine's members can tail. Emit is the only writer (M).
| Method | GET |
| Path | /api/chain/{slug}/events |
| Feature area | Chain & state |
| Tag | Chain & State |
| Auth | machine key — Authorization: Bearer $ZEQ_KEY |
| Tier | authenticated (machine-control) |
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
slug | string | yes | — |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
event | string | no | — |
limit | string | no | — |
since_zeqond | string | no | — |
No header parameters are published for this operation.
Request body
This operation takes no request body.
Responses
| Status | Meaning |
|---|---|
200 | OK |
401 | Missing or invalid credentials |
403 | Forbidden — authenticated, but not permitted for this resource |
404 | Not found |
500 | Server error |
401 body
| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean — one of false | yes | — |
error | string | no | Human-readable message. |
code | string | no | Stable machine-readable code, e.g. ADMIN_REQUIRED, INVALID_ZID, ZID_NOT_LINKED. |
403 body
| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean — one of false | yes | — |
error | string | no | Human-readable message. |
code | string | no | Stable machine-readable code, e.g. ADMIN_REQUIRED, INVALID_ZID, ZID_NOT_LINKED. |
404 body
| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean — one of false | yes | — |
error | string | no | Human-readable message. |
code | string | no | Stable machine-readable code, e.g. ADMIN_REQUIRED, INVALID_ZID, ZID_NOT_LINKED. |
500 body
| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean — one of false | yes | — |
error | string | no | Human-readable message. |
code | string | no | Stable machine-readable code, e.g. ADMIN_REQUIRED, INVALID_ZID, ZID_NOT_LINKED. |
Call it
curl -sS -X GET https://zeq.me/api/chain/your-machine/events?event=example&limit=example \
-H "Authorization: Bearer $ZEQ_KEY"
Needs a machine key. Mint one:
curl -sS -X POST https://zeq.me/api/demo-key/mint, then spin up your machine.
Generated from the live OpenAPI description (https://zeq.me/openapi.json, spec version 1.287.0) by scripts/generate-reference.mjs. Do not edit — this file is rewritten on every run.