---
title: "Project events and webhooks: the while.sh docs"
url: https://while.sh/en/docs/building-blocks/events/
updated: 2026-11-09
---

# Events

while pushes your projects' events, like a failed build or a requested approval, so your agent is notified without watching.

> You, to your agent: Let me know when a deployment fails.

## When to use it

So that your agent is notified without watching: it subscribes to the project's events.

## How it works

while pushes a project's events: a failed build, an app that went down, a rollback, an approval requested. They arrive as CloudEvents, through a signed webhook and through the MCP resource `while://projects/<project>/events`.

## Your agent's MCP tools

Your agent handles it with the `observe_app` tool.