Sign in

v50

latestSwagger 2.0MITraw.githubusercontent.com2026-07-15422691.7 KB
message

Websocket, return newly created messages.

get/stream

Response

Ok

appidinteger required

The application id that send this message.

datestring date-time required

The date the message was created.

extrasobject

The extra data sent along the message.

The extra fields are stored in a key-value scheme. Only accepted in CreateMessage requests with application/json content-type.

The keys should be in the following format: <top-namespace>::[<sub-namespace>::]<action>

These namespaces are reserved and might be used in the official clients: gotify android ios web server client. Do not use them for other purposes.

idinteger required

The message id.

messagestring required

The message. Markdown (excluding html) is allowed.

priorityinteger

The priority of the message. If unset, then the default priority of the application will be used.

titlestring

The title of the message.

Example response

{
  "appid": 5,
  "date": "2018-02-27T19:36:10.5045044+01:00",
  "extras": {
    "home::appliances::lighting::on": {
      "brightness": 15
    },
    "home::appliances::thermostat::change_temperature": {
      "temperature": 23
    }
  },
  "id": 25,
  "message": "**Backup** was successfully finished.",
  "priority": 2,
  "title": "Backup"
}