Get banners

Gets the banners to be shown to the authenticated user

URLRequires AuthHTTP Method

api/v1/banners

YES

GET

Headers

ArgumentExampleRequiredDescription

X-User-Id

myuser-name

Required

Your username hash (returned after you log in through the API)

X-Auth-Token

myauth-token

Required

Your token (returned after you log in through the API)

Query Params

ArgumentExampleRequiredDescription

platform

web

true

The platform rendering the banner

Example Call

curl --location --request GET 'http://localhost:3000/api/v1/banners?platform=web\
--header 'X-Auth-Token: myauth-token' \
--header 'X-User-Id: myuser-name'

Result

Success

{
    "banners": [],
    "success": true
}

Errors

The following errors can occur upon the endpoint.

  • Authorization: Requires an authentication token for the request to be made.

  • Missing Key: Requires platform key for the request to be made.

{
    "status": "error",
    "message": "You must be logged in to do this."
}

Last updated

Rocket.Chat versions receive support for six months after release.