Annonces

Créer une annonce

Publie une nouvelle annonce auprès de vos utilisateurs.

Scope requis announces:add

post/announcements

Authentification

Authorizationstringobligatoire

En-tête Authorization portant une clé d'API de l'espace de travail, sous la forme « Bearer kbn_live_… ». L'en-tête X-Api-Key est accepté de façon équivalente.

Corps de la requêteapplication/json

titlestringobligatoire

Titre.

contentstringobligatoire

Corps du texte.

typestringobligatoire

Type de la ressource.

startDatestring<date-time>obligatoire

Date de début.

endDatestring<date-time>

Date de fin.

teamsstring<uuid>[]

Équipes concernées.

appstring<uuid>

Application à laquelle l'annonce se rapporte.

Réponse201 · application/json

L'annonce a été créée.

idstring<uuid>obligatoire

Identifiant unique.

titlestringobligatoire

Titre affiché aux utilisateurs.

contentstringobligatoire

Corps de l'annonce.

typestringobligatoire

Type d'annonce.

teamsstring<uuid>[]

Équipes destinataires de l'annonce.

appstring<uuid> | null

Application à laquelle l'annonce se rapporte.

startDatestring<date-time>obligatoire

Date à partir de laquelle l'annonce est affichée.

endDatestring<date-time> | null

Date à laquelle l'annonce cesse d'être affichée.

createdAtstring<date-time>

Horodatage de création.

updatedAtstring<date-time>

Horodatage de la dernière modification, utilisable pour détecter les changements.

seenCountinteger

Nombre d'utilisateurs ayant vu l'annonce.

likeCountinteger

Nombre de réactions positives.

dislikeCountinteger

Nombre de réactions négatives.

likeRationumber | null

Part de réactions positives.