magicbell-api — quality + safety report

---
name: magicbell-api
description: "MagicBell API skill. Use when working with MagicBell for broadcasts, channels, events. Covers 126 endpoints."
version: 1.0.0
generator: lapsh
---

# MagicBell API
API version: 2.0.0

## Auth
Requires API key (key parameter)

## Base URL
https://api.magicbell.com/v2

## Setup
1. Include your API key via the key parameter
2. GET /broadcasts -- verify access
3. POST /broadcasts -- create first broadcasts

## Endpoints

126 endpoints across 6 groups. See references/api-spec.lap for full details.

### broadcasts
| Method | Path | Description |
|--------|------|-------------|
| GET | /broadcasts | Retrieves a paginated list of broadcasts for the project. Returns basic information about each broadcast including its creation time and status. |
| POST | /broadcasts | Creates a new broadcast message. When a broadcast is created, it generates individual notifications for relevant users within the project. Only administrators can create broadcasts. |
| GET | /broadcasts/{broadcast_id} | Retrieves detailed information about a specific broadcast by its ID. Includes the broadcast's configuration and current status. |

### channels
| Method | Path | Description |
|--------|------|-------------|
| GET | /channels/deliveryconfig |  |
| PUT | /channels/deliveryconfig |  |
| GET | /channels/mobile_push/apns/tokens | Lists all mobile_push tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata. |
| POST | /channels/mobile_push/apns/tokens | Saves a mobile_push token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel. |
| DELETE | /channels/mobile_push/apns/tokens/{token_id} | Revokes one of the authenticated user's mobile_push tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens. |
| GET | /channels/mobile_push/apns/tokens/{token_id} | Retrieves details of a specific mobile_push token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens. |
| GET | /channels/mobile_push/expo/tokens | Lists all mobile_push tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata. |
| POST | /channels/mobile_push/expo/tokens | Saves a mobile_push token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel. |
| DELETE | /channels/mobile_push/expo/tokens/{token_id} | Revokes one of the authenticated user's mobile_push tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens. |
| GET | /channels/mobile_push/expo/tokens/{token_id} | Retrieves details of a specific mobile_push token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens. |
| GET | /channels/mobile_push/fcm/tokens | Lists all mobile_push tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata. |
| POST | /channels/mobile_push/fcm/tokens | Saves a mobile_push token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel. |
| DELETE | /channels/mobile_push/fcm/tokens/{token_id} | Revokes one of the authenticated user's mobile_push tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens. |
| GET | /channels/mobile_push/fcm/tokens/{token_id} | Retrieves details of a specific mobile_push token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens. |
| GET | /channels/slack/tokens | Lists all slack tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata. |
| POST | /channels/slack/tokens | Saves a slack token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel. |
| DELETE | /channels/slack/tokens/{token_id} | Revokes one of the authenticated user's slack tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens. |
| GET | /channels/slack/tokens/{token_id} | Retrieves details of a specific slack token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens. |
| GET | /channels/teams/tokens | Lists all teams tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata. |
| POST | /channels/teams/tokens | Saves a teams token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel. |
| DELETE | /channels/teams/tokens/{token_id} | Revokes one of the authenticated user's teams tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens. |
| GET | /channels/teams/tokens/{token_id} | Retrieves details of a specific teams token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens. |
| GET | /channels/web_push/tokens | Lists all web_push tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata. |
| POST | /channels/web_push/tokens | Saves a web_push token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel. |
| DELETE | /channels/web_push/tokens/{token_id} | Revokes one of the authenticated user's web_push tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens. |
| GET | /channels/web_push/tokens/{token_id} | Retrieves details of a specific web_push token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens. |

### events
| Method | Path | Description |
|--------|------|-------------|
| GET | /events | Retrieves a paginated list of events for the project. |

### integrations
| Method | Path | Description |
|--------|------|-------------|
| GET | /integrations | List Integrations |
| DELETE | /integrations/apns | Removes a apns integration configuration from the project. This will disable the integration's functionality within the project. |
| GET | /integrations/apns | Retrieves the current apns integration configurations for a specific integration type in the project. Returns configuration details and status information. |
| PUT | /integrations/apns | Creates or updates a apns integration for the project. Only administrators can configure integrations. |
| DELETE | /integrations/apns/{id} | Removes a specific apns integration instance by ID from the project. |
| DELETE | /integrations/awssns | Removes a awssns integration configuration from the project. This will disable the integration's functionality within the project. |
| GET | /integrations/awssns | Retrieves the current awssns integration configurations for a specific integration type in the project. Returns configuration details and status information. |
| PUT | /integrations/awssns | Creates or updates a awssns integration for the project. Only administrators can configure integrations. |
| POST | /integrations/awssns/webhooks/incoming/{id} | Receives and processes incoming webhook events from the awssns integration. Each integration can define its own webhook payload format and handling logic. |
| DELETE | /integrations/awssns/{id} | Removes a specific awssns integration instance by ID from the project. |
| DELETE | /integrations/expo | Removes a expo integration configuration from the project. This will disable the integration's functionality within the project. |
| GET | /integrations/expo | Retrieves the current expo integration configurations for a specific integration type in the project. Returns configuration details and status information. |
| PUT | /integrations/expo | Creates or updates a expo integration for the project. Only administrators can configure integrations. |
| DELETE | /integrations/expo/{id} | Removes a specific expo integration instance by ID from the project. |
| DELETE | /integrations/fcm | Removes a fcm integration configuration from the project. This will disable the integration's functionality within the project. |
| GET | /integrations/fcm | Retrieves the current fcm integration configurations for a specific integration type in the project. Returns configuration details and status information. |
| PUT | /integrations/fcm | Creates or updates a fcm integration for the project. Only administrators can configure integrations. |
| DELETE | /integrations/fcm/{id} | Removes a specific fcm integration instance by ID from the project. |
| DELETE | /integrations/github | Removes a github integration configuration from the project. This will disable the integration's functionality within the project. |
| GET | /integrations/github | Retrieves the current github integration configurations for a specific integration type in the project. Returns configuration details and status information. |
| PUT | /integrations/github | Creates or updates a github integration for the project. Only administrators can configure integrations. |
| POST | /integrations/github/webhooks/incoming/{id} | Receives and processes incoming webhook events from the github integration. Each integration can define its own webhook payload format and handling logic. |
| DELETE | /integrations/github/{id} | Removes a specific github integration instance by ID from the project. |
| DELETE | /integrations/inbox | Removes a inbox integration configuration from the project. This will disable the integration's functionality within the project. |
| GET | /integrations/inbox | Retrieves the current inbox integration configurations for a specific integration type in the project. Returns configuration details and status information. |
| PUT | /integrations/inbox | Creates or updates a inbox integration for the project. Only administrators can configure integrations. |
| POST | /integrations/inbox/installations | Creates a new installation of a inbox integration for a user. This endpoint is used when an integration needs to be set up wi

… (truncated)