gitlab-org--gitlab-foss/doc/api/broadcast_messages.md
2016-08-31 17:03:19 -03:00

4.2 KiB

Broadcast Messages

Note: This feature was introduced in GitLab 8.12.

The broadcast message API is only accessible to administrators. All requests by guests will respond with 401 Unauthorized, and all requests by normal users will respond with 403 Forbidden.

Get all broadcast messages

GET /broadcast_messages
curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/broadcast_messages

Example response:

[
    {
        "message":"Example broadcast message",
        "starts_at":"2016-08-24T23:21:16.078Z",
        "ends_at":"2016-08-26T23:21:16.080Z",
        "color":"#E75E40",
        "font":"#FFFFFF",
        "id":1,
        "active": false
    }
]

Get a specific broadcast message

GET /broadcast_messages/:id
Attribute Type Required Description
id integer yes Broadcast message ID
curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/broadcast_messages/1

Example response:

{
    "message":"Deploy in progress",
    "starts_at":"2016-08-24T23:21:16.078Z",
    "ends_at":"2016-08-26T23:21:16.080Z",
    "color":"#cecece",
    "font":"#FFFFFF",
    "id":1,
    "active":false
}

Create a broadcast message

Responds with 400 Bad request when the message parameter is missing or the color or font values are invalid, and 201 Created when the broadcast message was successfully created.

POST /broadcast_messages
Attribute Type Required Description
message string yes Message to display
starts_at datetime no Starting time (defaults to current time)
ends_at datetime no Ending time (defaults to one hour from current time)
color string no Background color hex code
font string no Foreground color hex code
curl --data "message=Deploy in progress&color=#cecece" --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/broadcast_messages

Example response:

{
    "message":"Deploy in progress",
    "starts_at":"2016-08-26T00:41:35.060Z",
    "ends_at":"2016-08-26T01:41:35.060Z",
    "color":"#cecece",
    "font":"#FFFFFF",
    "id":1,
    "active": true
}

Update a broadcast message

PUT /broadcast_messages/:id
Attribute Type Required Description
id integer yes Broadcast message ID
message string no Message to display
starts_at datetime no Starting time
ends_at datetime no Ending time
color string no Background color hex code
font string no Foreground color hex code
curl --request PUT --data "message=Update message&color=#000" --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/broadcast_messages/1

Example response:

{
    "message":"Update message",
    "starts_at":"2016-08-26T00:41:35.060Z",
    "ends_at":"2016-08-26T01:41:35.060Z",
    "color":"#000",
    "font":"#FFFFFF",
    "id":1,
    "active": true
}

Delete a broadcast message

DELETE /broadcast_messages/:id
Attribute Type Required Description
id integer yes Broadcast message ID
curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/broadcast_messages/1

Example response:

{
    "message":"Update message",
    "starts_at":"2016-08-26T00:41:35.060Z",
    "ends_at":"2016-08-26T01:41:35.060Z",
    "color":"#000",
    "font":"#FFFFFF",
    "id":1,
    "active": true
}