Update a Timeline Beta

PATCH /api/timeline

Update an existing Timeline. You can update the title, description, date range, pinned events, pinned queries, and/or pinned saved queries of an existing Timeline.

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

Body Required

The Timeline updates, along with the Timeline ID and version.

Responses

PATCH /api/timeline
curl \
 -X PATCH https://<KIBANA_URL>/api/timeline \
 -H "Content-Type: application/json; Elastic-Api-Version=2023-10-31"
Request examples
{
  "timeline": {
    "columns": [
      {
        "aggregatable": true,
        "category": "string",
        "columnHeaderType": "string",
        "description": "string",
        "example": "string",
        "id": "string",
        "indexes": [
          "string"
        ],
        "name": "string",
        "placeholder": "string",
        "searchable": true,
        "type": "string"
      }
    ],
    "created": 42.0,
    "createdBy": "string",
    "dataProviders": [
      {
        "and": [
          {
            "enabled": true,
            "excluded": true,
            "id": "string",
            "kqlQuery": "string",
            "name": "string",
            "queryMatch": {
              "displayField": "string",
              "displayValue": "string",
              "field": "string",
              "operator": "string",
              "value": "string"
            },
            "type": "default"
          }
        ],
        "enabled": true,
        "excluded": true,
        "id": "string",
        "kqlQuery": "string",
        "name": "string",
        "queryMatch": {
          "displayField": "string",
          "displayValue": "string",
          "field": "string",
          "operator": "string",
          "value": "string"
        },
        "type": "default"
      }
    ],
    "dataViewId": "string",
    "dateRange": {
      "end": "string",
      "start": "string"
    },
    "description": "string",
    "eqlOptions": {
      "eventCategoryField": "string",
      "query": "string",
      "size": "string",
      "tiebreakerField": "string",
      "timestampField": "string"
    },
    "eventType": "string",
    "excludedRowRendererIds": [
      "alert"
    ],
    "favorite": [
      {
        "favoriteDate": 42.0,
        "fullName": "string",
        "userName": "string"
      }
    ],
    "filters": [
      {
        "exists": "string",
        "match_all": "string",
        "meta": {
          "alias": "string",
          "controlledBy": "string",
          "disabled": true,
          "field": "string",
          "formattedValue": "string",
          "index": "string",
          "key": "string",
          "negate": true,
          "params": "string",
          "type": "string",
          "value": "string"
        },
        "missing": "string",
        "query": "string",
        "range": "string",
        "script": "string"
      }
    ],
    "indexNames": [
      "string"
    ],
    "kqlMode": "string",
    "kqlQuery": {
      "filterQuery": {
        "kuery": {
          "expression": "string",
          "kind": "string"
        },
        "serializedQuery": "string"
      }
    },
    "savedQueryId": "string",
    "savedSearchId": "string",
    "sort": {
      "columnId": "string",
      "columnType": "string",
      "sortDirection": "string"
    },
    "status": "active",
    "templateTimelineId": "string",
    "templateTimelineVersion": 42.0,
    "timelineType": "default",
    "title": "string",
    "updated": 42.0,
    "updatedBy": "string"
  },
  "timelineId": "string",
  "version": "string"
}
Response examples (200)
{
  "columns": [
    {
      "aggregatable": true,
      "category": "string",
      "columnHeaderType": "string",
      "description": "string",
      "example": "string",
      "id": "string",
      "indexes": [
        "string"
      ],
      "name": "string",
      "placeholder": "string",
      "searchable": true,
      "type": "string"
    }
  ],
  "created": 42.0,
  "createdBy": "string",
  "dataProviders": [
    {
      "and": [
        {
          "enabled": true,
          "excluded": true,
          "id": "string",
          "kqlQuery": "string",
          "name": "string",
          "queryMatch": {
            "displayField": "string",
            "displayValue": "string",
            "field": "string",
            "operator": "string",
            "value": "string"
          },
          "type": "default"
        }
      ],
      "enabled": true,
      "excluded": true,
      "id": "string",
      "kqlQuery": "string",
      "name": "string",
      "queryMatch": {
        "displayField": "string",
        "displayValue": "string",
        "field": "string",
        "operator": "string",
        "value": "string"
      },
      "type": "default"
    }
  ],
  "dataViewId": "string",
  "dateRange": {
    "end": "string",
    "start": "string"
  },
  "description": "string",
  "eqlOptions": {
    "eventCategoryField": "string",
    "query": "string",
    "size": "string",
    "tiebreakerField": "string",
    "timestampField": "string"
  },
  "eventType": "string",
  "excludedRowRendererIds": [
    "alert"
  ],
  "favorite": [
    {
      "favoriteDate": 42.0,
      "fullName": "string",
      "userName": "string"
    }
  ],
  "filters": [
    {
      "exists": "string",
      "match_all": "string",
      "meta": {
        "alias": "string",
        "controlledBy": "string",
        "disabled": true,
        "field": "string",
        "formattedValue": "string",
        "index": "string",
        "key": "string",
        "negate": true,
        "params": "string",
        "type": "string",
        "value": "string"
      },
      "missing": "string",
      "query": "string",
      "range": "string",
      "script": "string"
    }
  ],
  "indexNames": [
    "string"
  ],
  "kqlMode": "string",
  "kqlQuery": {
    "filterQuery": {
      "kuery": {
        "expression": "string",
        "kind": "string"
      },
      "serializedQuery": "string"
    }
  },
  "savedQueryId": "string",
  "savedSearchId": "string",
  "sort": {
    "columnId": "string",
    "columnType": "string",
    "sortDirection": "string"
  },
  "status": "active",
  "templateTimelineId": "string",
  "templateTimelineVersion": 42.0,
  "timelineType": "default",
  "title": "string",
  "updated": 42.0,
  "updatedBy": "string",
  "savedObjectId": "string",
  "version": "string",
  "eventIdToNoteIds": [
    {
      "created": 42.0,
      "createdBy": "string",
      "eventId": "string",
      "note": "string",
      "timelineId": "string",
      "updated": 42.0,
      "updatedBy": "string",
      "noteId": "string",
      "version": "string"
    }
  ],
  "noteIds": [
    "string"
  ],
  "notes": [
    {
      "created": 42.0,
      "createdBy": "string",
      "eventId": "string",
      "note": "string",
      "timelineId": "string",
      "updated": 42.0,
      "updatedBy": "string",
      "noteId": "string",
      "version": "string"
    }
  ],
  "pinnedEventIds": [
    "string"
  ],
  "pinnedEventsSaveObject": [
    {
      "created": 42.0,
      "createdBy": "string",
      "eventId": "string",
      "timelineId": "string",
      "updated": 42.0,
      "updatedBy": "string",
      "pinnedEventId": "string",
      "version": "string"
    }
  ]
}
Response examples (405)
{
  "body": "string",
  "statusCode": 42.0
}