Get banner by id

Gets the banner to be shown to the authenticated user

URLRequires AuthHTTP Method

api/v1/banners/:id

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

Path Variable

ArgumentExampleRequiredDescription

id

ByehQjC44FwMeiLbX

true

The id of the banner

Example Call

curl --location --request GET 'http://localhost:3000/api/v1/banners/:id?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.