POST /api/saved_objects/_resolve_import_errors

Spaces method and path for this operation:

post /s/{space_id}/api/saved_objects/_resolve_import_errors

Refer to Spaces for more information.

To resolve errors from the import objects API, you can retry certain saved objects, overwrite specific saved objects, and change references to different saved objects

Headers

  • kbn-xsrf string Required

    A required header to protect against CSRF attacks

Query parameters

  • createNewCopies boolean

    Creates copies of saved objects, regenerates each object ID, and resets the origin.

    Default value is false.

  • compatibilityMode boolean

    Applies adjustments to maintain compatibility between different Kibana versions.

    Default value is false.

multipart/form-data

Body

  • file object Required
  • retries array[object] Required

    Not more than 10000 elements.

    Hide retries attributes Show retries attributes object
    • createNewCopy boolean
    • destinationId string
    • id string Required
    • ignoreMissingReferences boolean
    • overwrite boolean

      Default value is false.

    • replaceReferences array[object]

      Not more than 100 elements. Default value is [] (empty).

      Hide replaceReferences attributes Show replaceReferences attributes object
      • from string Required
      • to string Required
      • type string Required
    • type string Required

Responses

  • 200 application/json

    A successful resolve import errors response.

  • 400 application/json

    A bad request.

POST /api/saved_objects/_resolve_import_errors
curl \
  -X POST "${KIBANA_URL}/api/saved_objects/_resolve_import_errors" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true" \
  --form file=@file.ndjson \
  --form retries='[{"type":"dashboard","id":"example-dashboard-1","overwrite":true,"replaceReferences":[]}]'
POST kbn://api/saved_objects/_resolve_import_errors
Request example
{"file" => "file.ndjson", "retries" => [{"id" => "example-dashboard-1", "overwrite" => true, "replaceReferences" => [], "type" => "dashboard"}]}
Response examples (200)
{
  "errors": [],
  "success": true,
  "successCount": 1,
  "successResults": [
    {
      "id": "example-dashboard-1",
      "managed": false,
      "type": "dashboard"
    }
  ]
}
Response examples (400)
{
  "error": "Bad Request",
  "message": "Invalid file extension .txt",
  "statusCode": 400
}