# Push API

The Push operations of the BuildBase HTTP API: method, path, sign-in, request fields, answers and errors for each.

4 operations, 2 fully described. For how this part of BuildBase works, start with the [guide](/push-notifications/overview).

| Method | Path                                                                                          | What it does                                            |
| ------ | --------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| POST   | [`/api/v1/public/push/subscribe`](/http-api/reference/push/push-subscribe-create)             | Register a web push subscription for the signed-in user |
| GET    | [`/api/v1/public/push/subscriptions`](/http-api/reference/push/push-subscriptions-list)       | List the signed-in user's push subscriptions            |
| DELETE | [`/api/v1/public/push/unsubscribe`](/http-api/reference/push/push-unsubscribe-delete)         | Remove a push subscription by endpoint                  |
| GET    | [`/api/v1/public/push/vapid-public-key`](/http-api/reference/push/push-vapid-public-key-list) | Get the organization's VAPID public key for web push    |

## Related

- [API reference](/http-api/reference): every tag
- [Push guide](/push-notifications/overview)
