POST /Broadcast
Endpoint: POST /v1/pdapi/Broadcast
Auth: Bearer token
Permission: REST.Messages.Broadcast
Purpose
Broadcasts a chat message to the server.
Path parameters
None.
Query parameters
None.
Request body
JSON object with a required Message string.
Response schema
200 response schema
| Field | Type | Description |
|---|---|---|
Success |
boolean | true when the chat message was broadcast. |
Error responses
Error bodies use this shape:
| HTTP | Error code | When it happens |
|---|---|---|
401 |
INVALID_TOKEN |
The Authorization header is missing, malformed, or does not match a configured bearer token. |
403 |
MISSING_PERMISSION |
The token is valid, but it does not include this endpoint permission. |
400 |
INVALID_JSON |
A request body was supplied, but it could not be parsed as JSON. |
400 |
REQUEST_FAILED |
The game-thread callback threw an exception, or a shared player/resource resolver failed. |
500 |
REQUEST_TIMEOUT |
The internal game-thread callback did not complete within 5 seconds. |
400 |
VALIDATION_FAILED |
Message is missing, empty, or not a string. |
Examples
Broadcast a restart warning
Scenarios
- Announce scheduled maintenance.
- Send automated event start messages.
- Use POST /Alert when the message should be an alert instead of normal broadcast chat.