Favorite a Timeline or Timeline template

PATCH /api/timeline/_favorite

Api key auth Basic auth

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"}'

Request examples

{
  "templateTimelineId": "string",
  "templateTimelineVersion": 42.0,
  "timelineId": "string",
  "timelineType": "default"
}

Response examples (200)

{
  "data": {
    "persistFavorite": {
      "code": 42.0,
      "favorite": [
        {
          "userName": "elastic",
          "favoriteDate": 1741337636741
        }
      ],
      "message": "string",
      "savedObjectId": "string",
      "templateTimelineId": "string",
      "templateTimelineVersion": 42.0,
      "timelineType": "default",
      "version": "string"
    }
  }
}

Response examples (403)

{
  "body": "string",
  "statusCode": 42.0
}