Skip to content

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:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}
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

POST /v1/pdapi/Broadcast
{
    "Message": "Restart in 15 minutes."
}

Scenarios

  • Announce scheduled maintenance.
  • Send automated event start messages.
  • Use POST /Alert when the message should be an alert instead of normal broadcast chat.