POST /Alert

Endpoint: POST /v1/pdapi/Alert

Auth: Bearer token

Permission: REST.Messages.Alert

Purpose

Sends an alert message to the server.

None.

None.

JSON object with Message string.

Field	Type	Description
`Success`	boolean	`true` when the alert was broadcast.

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.
`400`	`BROADCAST_ALERT_FAILED`	The server failed to send the alert message.

POST /v1/pdapi/Alert

{
    "Message": "Restart now."
}

POST /v1/pdapi/Alert

{
    "Message": "Server restart in 5 minutes.\nPlease return to base."
}