# Notification Handlers

## GET /notifications

> List notification handlers

```json
{"openapi":"3.0.3","info":{"title":"Hydrozen.io API","version":"1.0.0"},"servers":[{"url":"https://app.hydrozen.io/api","description":"Production API server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"NotificationHandler":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["email","slack","webhook","telegram"]},"destination":{"type":"string"}}}}},"paths":{"/notifications":{"get":{"summary":"List notification handlers","tags":["Notification Handlers"],"responses":{"200":{"description":"List of notification handlers","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NotificationHandler"}}}}}}}}}}
```

## POST /notifications

> Create a new notification handler

```json
{"openapi":"3.0.3","info":{"title":"Hydrozen.io API","version":"1.0.0"},"servers":[{"url":"https://app.hydrozen.io/api","description":"Production API server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"NotificationHandler":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["email","slack","webhook","telegram"]},"destination":{"type":"string"}}}}},"paths":{"/notifications":{"post":{"summary":"Create a new notification handler","tags":["Notification Handlers"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"destination":{"type":"string"}}}}}},"responses":{"201":{"description":"Notification handler created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationHandler"}}}}}}}}}
```

## GET /notifications/{id}

> Retrieve notification handler

```json
{"openapi":"3.0.3","info":{"title":"Hydrozen.io API","version":"1.0.0"},"servers":[{"url":"https://app.hydrozen.io/api","description":"Production API server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"NotificationHandler":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["email","slack","webhook","telegram"]},"destination":{"type":"string"}}}}},"paths":{"/notifications/{id}":{"get":{"summary":"Retrieve notification handler","tags":["Notification Handlers"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Notification handler details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationHandler"}}}}}}}}}
```

## DELETE /notifications/{id}

> Delete notification handler

```json
{"openapi":"3.0.3","info":{"title":"Hydrozen.io API","version":"1.0.0"},"servers":[{"url":"https://app.hydrozen.io/api","description":"Production API server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/notifications/{id}":{"delete":{"summary":"Delete notification handler","tags":["Notification Handlers"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Notification handler deleted"}}}}}}
```