Kurrent Streams API is one of 9 APIs that Kurrent publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Streams. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.
This API exposes
11 operations
across 8 paths,
and defines 7 schemas.
It is described by OpenAPI 3.1.0, at version v26.1.
Requests are made against a single base URL, https://{host}:{port}.
11 operations8 paths7 schemas1 DELETE7 GET3 POST
Metadata
The identity and technical contract details declared by the specification.
Kurrent Streams API declares
1 security scheme
for authenticating requests.
It accepts HTTP basic authentication (basicAuth).
By default, every request must be authenticated.
basicAuth — KurrentDB supports HTTP Basic authentication for the HTTP API, with access control lists (ACLs) applied per stream. See https://docs.kurrent.io/server/v26.1/ht…
Paths & Operations 11
Across 8 paths, the API surfaces 11 operations — 1 DELETE, 7 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.
Streams 11
Append to, read from and manage event streams
GET
/streams/{stream}
Read events from a stream
readStream2 params→ 200401404
POST
/streams/{stream}
Append one or more events to a stream
appendToStream5 paramsbody→ 201307400401
DELETE
/streams/{stream}
Delete a stream
deleteStream3 params→ 204400401404
POST
/streams/{stream}/incoming/{guid}
Append a single event using a client-supplied event id (idempotent append URL)
Read a page of events from a stream starting at an event number
readEvents3 params→ 200401404
GET
/streams/{stream}/{event}/backward/{count}
Page backward through a stream from an event number
readEventsBackward3 params→ 200401404
GET
/streams/{stream}/{event}/forward/{count}
Page forward through a stream from an event number
readEventsForward3 params→ 200401404
GET
/streams/$all
Read events from the $all stream
readAllStream1 param→ 200401
Schemas 7
The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are AtomEntry (15 properties), AtomFeed (8 properties), StreamMetadata (5 properties), StreamAcl (5 properties). Each schema is shown below with its type and property counts.
AtomFeed
object
An AtomPub feed of events from a stream
8 properties
AtomEntry
object
A single event entry in an AtomPub feed
15 properties
StreamAcl
object
Access control list applied to a stream
5 properties
Event
object
A single event written to a KurrentDB stream
4 properties3 required
EventBatch
array
One or more events to append to a stream
AtomLink
object
A navigation link in an AtomPub feed (first, last, previous, next, metadata)
2 properties
StreamMetadata
object
Metadata controlling the retention and access of a stream
5 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
