Favorite a Timeline or Timeline template

PATCH /api/timeline/_favorite

Favorite a Timeline or Timeline template for the current user.

application/json

Body Required

The required fields used to favorite a (template) Timeline.

  • templateTimelineId string | null Required
  • templateTimelineVersion number | null Required
  • timelineId string | null Required
  • timelineType string | null Required

    The type of Timeline.

    Values are default or template.

Responses

  • 200 application/json

    Indicates the favorite status was successfully updated.

    Hide response attribute Show response attribute object
    • data object Required
      Hide data attribute Show data attribute object
      • persistFavorite object Required
        Hide persistFavorite attributes Show persistFavorite attributes object
        • code number | null
        • favorite array[object]

          Indicates when and who marked a Timeline as a favorite.

          Hide favorite attributes Show favorite attributes object
          • favoriteDate number | null
          • fullName string | null
          • userName string | null
        • message string | null
        • savedObjectId string Required
        • templateTimelineId string | null
        • templateTimelineVersion number | null
        • timelineType string | null

          The type of Timeline.

          Values are default or template.

        • version string Required
  • 403 application:json

    Indicates the user does not have the required permissions to persist the favorite status.

    Hide response attributes Show response attributes object
    • body string
    • statusCode number
PATCH /api/timeline/_favorite
curl \
 --request PATCH 'https://localhost:5601/api/timeline/_favorite' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"templateTimelineId":"string","templateTimelineVersion":42.0,"timelineId":"string","timelineType":"default"}'