---
search:
  tags:
    - Agent
    - POST
seo:
  description: >-
    Up to 20 devices. Per-device authorization and schema checks apply. Results
    are… Reference for the POST /v1/broadcasts endpoint in the openlaunch API.
sidebar:
  label: Request action on multiple devices
  badge: POST
title: Request action on multiple devices
type: openapi-operation
---
Up to 20 devices. Per-device authorization and schema checks apply. Results are independent; broadcast is not atomic. TTL defaults to 30 seconds and is at most 300 seconds.

`POST /v1/broadcasts`

**curl**

```bash
curl -X POST "${OPENLAUNCH_URL:-https://www.openlaunch.dev}/v1/broadcasts" -H "Authorization: Bearer $OPENLAUNCH_AGENT_TOKEN" -H 'Content-Type: application/json' -d '{"deviceIds":["00000000-0000-4000-8000-000000000001"],"capability":"device.health","arguments":{},"idempotencyKey":"broadcast-001"}'
```

**openlaunch SDK**

```ts
import { createClient } from "@openlaunch/sdk";
const agent = createClient({ url: process.env.OPENLAUNCH_URL ?? "https://www.openlaunch.dev", token: process.env.OPENLAUNCH_AGENT_TOKEN! });
const results = await agent.broadcast({ deviceIds, capability: "device.health", arguments: {}, idempotencyKey: "broadcast-001" });
```