Get all banners.

GET 
<your-unleash-url>/api/admin/banners

Returns a list of all configured banners.

Responses

200

bannersSchema

application/json

Schema

Schema

banners object[]required
A list of banners.
Array [
id integerrequired
The banner's ID. Banner IDs are incrementing integers. In other words, a more recently created banner will always have a higher ID than an older one.
Possible values: >= 1
Example: 7
message stringrequired
The message to display to all users. Supports markdown.
Example: **Reminder to everyone**: Maintenance is scheduled for *2337-12-27*.
enabled boolean
Whether the banner should be displayed currently. If not specified, defaults to true.
Example: true
variant string
The variant of the banner. One of "info", "warning", "error", or "success". If not specified, defaults to "info".
Example: info
sticky boolean
Whether the banner should be sticky on the screen. If not specified, defaults to false.
Example: true
icon stringnullable
The icon to display on the banner. Can be one of https://fonts.google.com/icons. If not specified, this will be the default icon for the variant. If "none", no icon will be displayed.
Example: build
link stringnullable
The link to display on the banner. Can either be an absolute or a relative link (e.g. absolute: "https://example.com" or relative: "/admin/service-accounts"). If "dialog", will display a dialog when clicked. If not specified, no link will be displayed.
Example: dialog
linkText stringnullable
The text to display on the link. If not specified, will be displayed as "More info".
Example: Learn more
dialogTitle stringnullable
The title to display on the dialog. If not specified, this will be the same as linkText.
Example: Learn more about it here
dialog stringnullable
The markdown to display on the dialog. If not specified, no dialog will be displayed.
Example: # Information Maintenance is **scheduled**. ## More details This is an example dialog that supports Markdown.
createdAt date-timerequired
The date and time of when the banner was created.
Example: 2023-12-27T13:37:00+01:00
]

Example (auto)

{
  "banners": [
    {
      "id": 7,
      "message": "**Reminder to everyone**: Maintenance is scheduled for *2337-12-27*.",
      "enabled": true,
      "variant": "info",
      "sticky": true,
      "icon": "build",
      "link": "dialog",
      "linkText": "Learn more",
      "dialogTitle": "Learn more about it here",
      "dialog": "# Information\n\nMaintenance is **scheduled**.\n\n## More details\n\nThis is an example dialog that supports Markdown.",
      "createdAt": "2023-12-27T13:37:00+01:00"
    }
  ]
}

401

Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.

application/json

Schema

Schema

id string
The ID of the error instance
Example: 9c40958a-daac-400e-98fb-3bb438567008
name string
The name of the error kind
Example: AuthenticationRequired
message string
A description of what went wrong.
Example: You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login.

Example (auto)

{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "AuthenticationRequired",
  "message": "You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login."
}

Authorization: Authorization

name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L '<your-unleash-url>/api/admin/banners' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'

Request Collapse all

Base URL

<your-unleash-url>

Auth

Security Scheme

apiKeybearerToken

apiKey

ResponseClear

Click the Send API Request button above and see the response here!