---
title: "Get an event stream"
method: GET
path: "/events/stream"
tags: ["events"]
---

# Get an event stream

`GET /events/stream`

The connection will be upgraded to use the websocket protocol.

## Query parameters

- `ack` boolean
- `since` string, date-time
- `roots` string[]

## Other responses

- `101` — HTTP/1.1 ["Switching Protocols" response status code](https://tools.ietf.org/html/rfc7231#section-6.2.2)
- `400` — HTTP/1.1 ["Bad Request" response status code](https://tools.ietf.org/html/rfc7231#section-6.5.1)
- `500` — HTTP/1.1 ["Internal Server Error" response status code](https://tools.ietf.org/html/rfc7231#section-6.6.1)

## Changes

- **2020-11-03** `493a631ec454` — 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3, subschema #6` to the `items/` response property `oneOf` list for the response status `101`
  - removed `subschema #1, subschema #2, subschema #3, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10, subschema #11, subschema #12` from the `items/` response property `oneOf` list for the response status `101`
- **2020-10-25** `d18772f57377` — 1 warning, 1 info
  - removed the optional property `items/oneOf[subschema #1]/callEndedEvent` from the response with the `101` status
  - added the optional property `items/oneOf[subschema #1]/callEnded` to the response with the `101` status
- **2019-12-17** `b2cf9c0a6a30` — 1 breaking
  - added `subschema #1, subschema #10, subschema #12` to the `items/` response property `oneOf` list for the response status `101`
- **2019-07-16** `6d0123d8047b` — 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9` to the `items/` response property `oneOf` list for the response status `101`
  - removed `subschema #1, subschema #2, subschema #3, subschema #6` from the `items/` response property `oneOf` list for the response status `101`

[Change history](https://skmtc.dev/opctl/apis/opctl-rest-api/changes/events/stream/get.md)

---

[API](https://skmtc.dev/opctl/apis/opctl-rest-api.md) · [All operations](https://skmtc.dev/opctl/apis/opctl-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opctl/opctl-rest-api/revisions/57a79c2e7e27/schema)