Retrieves a draft timeline or timeline template.

POST /api/timeline/_draft

Retrieves a clean draft timeline. If a draft timeline does not exist, it is created and returned.

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

Body Required

The type of timeline to create. Valid values are default and template.

  • timelineType string | null Required

    The type of timeline to create. Valid values are default and template.

    Values are default or template.

Responses

POST /api/timeline/_draft
curl \
 -X POST https://localhost:5601/api/timeline/_draft \
 -H "Content-Type: application/json; Elastic-Api-Version=2023-10-31"
Request examples
{
  "timelineType": "default"
}
Response examples (200)
{
  "data": {
    "persistTimeline": {
      "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"
                }
              }
            ],
            "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": true,
            "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",
        "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",
            "pinnedEventId": "string",
            "timelineId": "string",
            "updated": 42.0,
            "updatedBy": "string",
            "version": "string"
          }
        ],
        "savedObjectId": "string",
        "version": "string"
      }
    }
  }
}
Response examples (403)
{
  "message": "string",
  "status_code": 42.0
}
Response examples (409)
{
  "message": "string",
  "status_code": 42.0
}