---
title: "Send a Broadcast Action"
method: POST
path: "/v1/default/device/broadcast"
tags: ["device-action-api"]
---

# Send a Broadcast Action

`POST /v1/default/device/broadcast`

## Request

- Base URL: `https://api.bymason.com`
- URL: `https://api.bymason.com/v1/default/device/broadcast`
- Auth: API key in header `Authorization`

Sends a Broadcast Action to a list of devices. A Broadcast is a mechanism to deliver
a command to your Android application.

As a best practice, you should never send sensitive data over a broadcast. If you have
sensitive data, it's best to send an identifier to your storage over the broadcast, or
to encrypt the data.

## Request body

- BroadcastRequest: Broadcast request to send a Command to an Android application running on your device.
  - `devices` string[]: List of device ids to send the Command to
  - `targetApps` unknown[]: List of applications to receive the Command on you devices
    - unknown
  - `command` string: Command to send to the applications
  - `args` string[]: A list of arguments to send with the Command

## Response `204`

No content

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/bymason/apis/mason-platform-apis-docs.md) - [All operations](https://skmtc.dev/bymason/apis/mason-platform-apis-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/bymason/apis/mason-platform-apis-docs/revisions/365b123b04d4?raw)