---
title: "A swarm's progress as Server-Sent Events"
url: https://hexelstudio.com/docs/api/harness/streams/a-swarm-s-progress-as-server-sent-events
---

# A swarm's progress as Server-Sent Events

**GET** `/harness/swarms/{id}/events`

A `swarm.progress` event (`SwarmProgress` with `state`) whenever it changes, a
`swarm.stage` event (`StageProgress`) for a pipeline's stages, then `end` once the swarm
is final. `follow=false` sends the current progress and ends.


## Headers

- `Authorization: string`

  `Bearer <token>`. A Hexel Studio access token for your organization.

- `X-Workspace-Id: string`

  The workspace the request acts in (`ws_...`). It never grants access by itself.

- `X-Environment-Id: string`

  The environment the request acts in (`env_...`). It never grants access by itself.

## Returns

`200` 

## Errors

- `default` 

## Example

```bash
curl --request GET \
  --url 'https://api.hexelstudio.com/v1/harness/swarms/{id}/events' \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header 'X-Workspace-Id: X_WORKSPACE_ID' \
  --header 'X-Environment-Id: X_ENVIRONMENT_ID'
```
