Favorite a Timeline or Timeline template

Favorite a Timeline or Timeline template Beta

PATCH /api/timeline/_favorite

Favorite a Timeline or Timeline template for the current user.

application/json; Elastic-Api-Version=2023-10-31

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 to create. Valid values are default and template.

Values are default or template.

Responses

200 application/json; Elastic-Api-Version=2023-10-31

Indicates the favorite status was successfully updated.
Hide response attributes Show response attributes object
- favorite array[object]
  
  Hide favorite attributes Show favorite attributes object
  
  favoriteDate number | null
  
  fullName string | null
  
  userName string | null
- savedObjectId string Required
- templateTimelineId string | null
- templateTimelineVersion number | null
- timelineType string | null
  
  The type of timeline to create. Valid values are default and template.
  
  Values are default or template.
- version string Required
403 application:json; Elastic-Api-Version=2023-10-31

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 \
 -X PATCH https://<KIBANA_URL>/api/timeline/_favorite \
 -H "Content-Type: application/json; Elastic-Api-Version=2023-10-31"

Request examples

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

Response examples (200)

{
  "favorite": [
    {
      "favoriteDate": 42.0,
      "fullName": "string",
      "userName": "string"
    }
  ],
  "savedObjectId": "string",
  "templateTimelineId": "string",
  "templateTimelineVersion": 42.0,
  "timelineType": "default",
  "version": "string"
}

Response examples (403)

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