---
title: "Subscribe pouchd events to users"
method: GET
path: "/events"
---

# Subscribe pouchd events to users

`GET /events`

Stream real-time events from the server.
Report various object events of pouchd when something happens to them.
Containers report these events: create`, `destroy`, `die`, `oom`, `pause`, `rename`, `resize`, `restart`, `start`, `stop`, `top`, `unpause`, `update` and `exec_die`
Images report these events: `pull`, `untag`
Volumes report these events: `create`, `destroy`
Networks report these events: `create`, `connect`, `disconnect`, `destroy`

## Query parameters

- `since` string
- `until` string
- `filters` string

## Response `200`

no error

- EventsMessage — EventsMessage represents the information an event contains, the message at least contains type, action and id. type specifies which object generates the event, like container, or a network, or a volume. the action specifies the action name, like create, or destroy. the id identifies the object that generates the event. The message also can contain the EventsActor that describes the extra attributes that describe the event.
  - `status` string
  - `id` string
  - `from` string
  - `type` 'container' | 'daemon' | 'image' | 'network' | 'plugin' | 'volume' — The type of event. For example, "container" or "image", Now we only support container, image, network and volume events.
  - `action` string
  - `actor` EventsActor — EventsActor describes something that generates events, like a container, or a network, or a volume. It has a defined name and a set or attributes. The container attributes are its labels, other actors can generate these attributes from other properties.
    - `ID` string
    - `Attributes` object
  - `time` integer
  - `timeNano` integer

## Other responses

- `400` — bad parameter
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.net/aliyun/apis/pouch-engine-api.md) · [All operations](https://skmtc.net/aliyun/apis/pouch-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aliyun/pouch-engine-api/versions/36d75b2825fc/schema)