Sign in
Admin: Banners

Changed on

Create a banner. A body violating the schema (e.g. an empty body) surfaces as 400 via the central handler; banners carry no uniqueness constraint, so there is no 409 path.

post/api/admin/banners

Request

  • The document declares no server URL.
  • Auth: API key in cookie JWT and API key in header X-XSRF-TOKEN

Request body

state'draft' | 'published' | 'archived' required

Banner publication state.

background'cta_gradient' | 'dark' | 'blue' required

Banner display background.

locale'ru' | 'en' required

Banners only target ru/en today (legacy BannerLocale).

bodystring required
urlstring nullable required
startsAtstring date-time nullable required
finishesAtstring date-time nullable required

Response

The request has succeeded and a new resource has been created as a result.

idinteger required
locale'ru' | 'en' required

Banners only target ru/en today (legacy BannerLocale).

bodystring required
urlstring nullable required
background'cta_gradient' | 'dark' | 'blue' required

Banner display background.

state'draft' | 'published' | 'archived' required

Banner publication state.

startsAtstring date-time nullable required
finishesAtstring date-time nullable required
createdAtstring date-time required

Changes