Revoke an event stream
/event-streams/{event_stream_id}Revokes the event stream and closes any open connection to it shortly afterward.
The stream is not removed: it remains available through the retrieve and list operations with the revoked status.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/event-streams/string"Retrieve an event stream GET
Returns the event stream's status, filters, delivery cursor, and connection state. Revoked and expired event streams remain retrievable.
Connect to an event stream GET
Opens the Server-Sent Events connection for an event stream. Send `Accept: text/event-stream` and authenticate with the `Authorization` header; credentials in the query string are not accepted. Each message carries the event's public ID in `id`, its type in `event`, and in `data` the same JSON returned when retrieving the event. Without a `Last-Event-ID` header, delivery resumes from the stream's stored cursor; with it, delivery resumes after that event. Keep-alive comments are sent periodically. Only one connection per stream is allowed at a time. The server closes the connection after a maximum duration, or when the stream expires, is revoked, or the credential is revoked; reconnect with `Last-Event-ID` to continue. Each connection extends the stream's expiration. Delivery has a latency of a few seconds and is not real-time.