From 0b675b89084b18faa1db1ca99ecd500a78af8f57 Mon Sep 17 00:00:00 2001
From: Kaarina Tungseth <kaarina.tungseth@elastic.co>
Date: Tue, 14 Jul 2020 14:59:21 -0500
Subject: [PATCH] [DOCS] Fixes to API docs (#71678)

* [DOCS] Fixes to API docs

* Fixes rogue -u
---
 docs/api/dashboard/export-dashboard.asciidoc  |  2 +-
 docs/api/dashboard/import-dashboard.asciidoc  |  2 +-
 .../create-logstash.asciidoc                  |  2 +-
 .../delete-pipeline.asciidoc                  |  2 +-
 docs/api/role-management/put.asciidoc         | 10 +++++-----
 docs/api/saved-objects/bulk_create.asciidoc   |  2 +-
 docs/api/saved-objects/bulk_get.asciidoc      |  2 +-
 docs/api/saved-objects/create.asciidoc        |  2 +-
 docs/api/saved-objects/delete.asciidoc        |  2 +-
 docs/api/saved-objects/export.asciidoc        |  8 ++++----
 docs/api/saved-objects/find.asciidoc          |  4 ++--
 docs/api/saved-objects/get.asciidoc           |  4 ++--
 docs/api/saved-objects/import.asciidoc        |  6 +++---
 .../resolve_import_errors.asciidoc            |  6 +++---
 docs/api/saved-objects/update.asciidoc        |  2 +-
 .../copy_saved_objects.asciidoc               |  4 ++--
 docs/api/spaces-management/post.asciidoc      |  2 +-
 docs/api/spaces-management/put.asciidoc       |  2 +-
 ...olve_copy_saved_objects_conflicts.asciidoc |  2 +-
 .../batch_reindexing.asciidoc                 |  6 ++++--
 .../check_reindex_status.asciidoc             |  1 +
 docs/api/url-shortening.asciidoc              | 19 ++++++++++++-------
 docs/api/using-api.asciidoc                   |  2 +-
 23 files changed, 51 insertions(+), 43 deletions(-)

diff --git a/docs/api/dashboard/export-dashboard.asciidoc b/docs/api/dashboard/export-dashboard.asciidoc
index 36c551dee84f..2099fb599ba6 100644
--- a/docs/api/dashboard/export-dashboard.asciidoc
+++ b/docs/api/dashboard/export-dashboard.asciidoc
@@ -35,7 +35,7 @@ experimental[] Export dashboards and corresponding saved objects.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X GET "localhost:5601/api/kibana/dashboards/export?dashboard=942dcef0-b2cd-11e8-ad8e-85441f0c2e5c" <1>
+$ curl -X GET api/kibana/dashboards/export?dashboard=942dcef0-b2cd-11e8-ad8e-85441f0c2e5c <1>
 --------------------------------------------------
 // KIBANA
 
diff --git a/docs/api/dashboard/import-dashboard.asciidoc b/docs/api/dashboard/import-dashboard.asciidoc
index 320859f78c61..020ec8018b85 100644
--- a/docs/api/dashboard/import-dashboard.asciidoc
+++ b/docs/api/dashboard/import-dashboard.asciidoc
@@ -42,7 +42,7 @@ Use the complete response body from the <<dashboard-api-export, Export dashboard
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/kibana/dashboards/import?exclude=index-pattern"
+$ curl -X POST api/kibana/dashboards/import?exclude=index-pattern
 {
   "objects": [
     {
diff --git a/docs/api/logstash-configuration-management/create-logstash.asciidoc b/docs/api/logstash-configuration-management/create-logstash.asciidoc
index d6ad27fe4460..9bd5a9028ee9 100644
--- a/docs/api/logstash-configuration-management/create-logstash.asciidoc
+++ b/docs/api/logstash-configuration-management/create-logstash.asciidoc
@@ -41,7 +41,7 @@ experimental[] Create a centrally-managed Logstash pipeline, or update an existi
 
 [source,sh]
 --------------------------------------------------
-$ curl -X PUT "localhost:5601/api/logstash/pipeline/hello-world"
+$ curl -X PUT api/logstash/pipeline/hello-world
 {
   "pipeline": "input { stdin {} } output { stdout {} }",
   "settings": {
diff --git a/docs/api/logstash-configuration-management/delete-pipeline.asciidoc b/docs/api/logstash-configuration-management/delete-pipeline.asciidoc
index e982619ee17f..8f8220770cb2 100644
--- a/docs/api/logstash-configuration-management/delete-pipeline.asciidoc
+++ b/docs/api/logstash-configuration-management/delete-pipeline.asciidoc
@@ -28,6 +28,6 @@ experimental[] Delete a centrally-managed Logstash pipeline.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X DELETE "localhost:5601/api/logstash/pipeline/hello-world"
+$ curl -X DELETE api/logstash/pipeline/hello-world
 --------------------------------------------------
 // KIBANA
diff --git a/docs/api/role-management/put.asciidoc b/docs/api/role-management/put.asciidoc
index 993d75780c87..be4617810009 100644
--- a/docs/api/role-management/put.asciidoc
+++ b/docs/api/role-management/put.asciidoc
@@ -63,7 +63,7 @@ Grant access to various features in all spaces:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X PUT "localhost:5601/api/security/role/my_kibana_role"
+$ curl -X PUT api/security/role/my_kibana_role
 {
   "metadata" : {
     "version" : 1
@@ -132,7 +132,7 @@ Grant dashboard-only access to only the Marketing space:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X PUT "localhost:5601/api/security/role/my_kibana_role"
+$ curl -X PUT api/security/role/my_kibana_role
 {
   "metadata" : {
     "version" : 1
@@ -160,7 +160,7 @@ Grant full access to all features in the Default space:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X PUT "localhost:5601/api/security/role/my_kibana_role"
+$ curl -X PUT api/security/role/my_kibana_role
 {
   "metadata" : {
     "version" : 1
@@ -187,7 +187,7 @@ Grant different access to different spaces:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X PUT "localhost:5601/api/security/role/my_kibana_role"
+$ curl -X PUT api/security/role/my_kibana_role
 {
   "metadata" : {
     "version" : 1
@@ -223,7 +223,7 @@ Grant access to {kib} and {es}:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X PUT "localhost:5601/api/security/role/my_kibana_role"
+$ curl -X PUT api/security/role/my_kibana_role
 {
   "metadata" : {
     "version" : 1
diff --git a/docs/api/saved-objects/bulk_create.asciidoc b/docs/api/saved-objects/bulk_create.asciidoc
index fbd4c6e77f8b..4f572b49ee5f 100644
--- a/docs/api/saved-objects/bulk_create.asciidoc
+++ b/docs/api/saved-objects/bulk_create.asciidoc
@@ -65,7 +65,7 @@ Create an index pattern with the `my-pattern` ID, and a dashboard with the `my-d
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_bulk_create"
+$ curl -X POST api/saved_objects/_bulk_create
 [
   {
     "type": "index-pattern",
diff --git a/docs/api/saved-objects/bulk_get.asciidoc b/docs/api/saved-objects/bulk_get.asciidoc
index 1d2c9cc32d43..e31bbf145218 100644
--- a/docs/api/saved-objects/bulk_get.asciidoc
+++ b/docs/api/saved-objects/bulk_get.asciidoc
@@ -52,7 +52,7 @@ Retrieve an index pattern with the `my-pattern` ID, and a dashboard with the `my
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_bulk_get"
+$ curl -X POST api/saved_objects/_bulk_get
 [
   {
     "type": "index-pattern",
diff --git a/docs/api/saved-objects/create.asciidoc b/docs/api/saved-objects/create.asciidoc
index 11e061776122..900f87ec29d8 100644
--- a/docs/api/saved-objects/create.asciidoc
+++ b/docs/api/saved-objects/create.asciidoc
@@ -57,7 +57,7 @@ any data that you send to the API is properly formed.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/index-pattern/my-pattern"  -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
+$ curl -X POST api/saved_objects/index-pattern/my-pattern  -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
 {
   "attributes": {
     "title": "my-pattern-*"
diff --git a/docs/api/saved-objects/delete.asciidoc b/docs/api/saved-objects/delete.asciidoc
index 65c955e15d36..af587b0e7af1 100644
--- a/docs/api/saved-objects/delete.asciidoc
+++ b/docs/api/saved-objects/delete.asciidoc
@@ -39,6 +39,6 @@ Delete an index pattern object with the `my-pattern` ID:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X DELETE "localhost:5601/api/saved_objects/index-pattern/my-pattern"
+$ curl -X DELETE api/saved_objects/index-pattern/my-pattern
 --------------------------------------------------
 // KIBANA
diff --git a/docs/api/saved-objects/export.asciidoc b/docs/api/saved-objects/export.asciidoc
index a992d13ed9b9..1b28d8bcbea8 100644
--- a/docs/api/saved-objects/export.asciidoc
+++ b/docs/api/saved-objects/export.asciidoc
@@ -68,7 +68,7 @@ Export all index pattern saved objects:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_export" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
+$ curl -X POST api/saved_objects/_export -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
 {
   "type": "index-pattern"
 }'
@@ -79,7 +79,7 @@ Export all index pattern saved objects and exclude the export summary from the s
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_export" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
+$ curl -X POST api/saved_objects/_export -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
 {
   "type": "index-pattern",
   "excludeExportDetails": true
@@ -91,7 +91,7 @@ Export a specific saved object:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_export" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
+$ curl -X POST api/saved_objects/_export -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
 {
   "objects": [
     {
@@ -107,7 +107,7 @@ Export a specific saved object and it's related objects :
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_export" -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
+$ curl -X POST api/saved_objects/_export -H 'kbn-xsrf: true' -H 'Content-Type: application/json' -d '
 {
   "objects": [
     {
diff --git a/docs/api/saved-objects/find.asciidoc b/docs/api/saved-objects/find.asciidoc
index e82c4e0c00d1..ad0711256747 100644
--- a/docs/api/saved-objects/find.asciidoc
+++ b/docs/api/saved-objects/find.asciidoc
@@ -69,7 +69,7 @@ Find index patterns with titles that start with `my`:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X GET "localhost:5601/api/saved_objects/_find?type=index-pattern&search_fields=title&search=my*"
+$ curl -X GET api/saved_objects/_find?type=index-pattern&search_fields=title&search=my*
 --------------------------------------------------
 // KIBANA
 
@@ -97,6 +97,6 @@ query parameter for each value:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X GET "localhost:5601/api/saved_objects/_find?fields=id&fields=title"
+$ curl -X GET api/saved_objects/_find?fields=id&fields=title
 --------------------------------------------------
 // KIBANA
diff --git a/docs/api/saved-objects/get.asciidoc b/docs/api/saved-objects/get.asciidoc
index 86b86795b534..6aad9759ef5e 100644
--- a/docs/api/saved-objects/get.asciidoc
+++ b/docs/api/saved-objects/get.asciidoc
@@ -39,7 +39,7 @@ Retrieve the index pattern object with the `my-pattern` ID:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X GET "localhost:5601/api/saved_objects/index-pattern/my-pattern"
+$ curl -X GET api/saved_objects/index-pattern/my-pattern
 --------------------------------------------------
 // KIBANA
 
@@ -61,7 +61,7 @@ Retrieve a dashboard object in the `testspace` by ID:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X GET "localhost:5601/s/testspace/api/saved_objects/dashboard/7adfa750-4c81-11e8-b3d7-01146121b73d"
+$ curl -X GET s/testspace/api/saved_objects/dashboard/7adfa750-4c81-11e8-b3d7-01146121b73d
 --------------------------------------------------
 // KIBANA
 
diff --git a/docs/api/saved-objects/import.asciidoc b/docs/api/saved-objects/import.asciidoc
index b3e4c48696a1..abf20b44cd17 100644
--- a/docs/api/saved-objects/import.asciidoc
+++ b/docs/api/saved-objects/import.asciidoc
@@ -57,7 +57,7 @@ Import an index pattern and dashboard:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_import" -H "kbn-xsrf: true" --form file=@file.ndjson
+$ curl -X POST api/saved_objects/_import -H "kbn-xsrf: true" --form file=@file.ndjson
 --------------------------------------------------
 // KIBANA
 
@@ -83,7 +83,7 @@ Import an index pattern and dashboard that includes a conflict on the index patt
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_import" -H "kbn-xsrf: true" --form file=@file.ndjson
+$ curl -X POST api/saved_objects/_import -H "kbn-xsrf: true" --form file=@file.ndjson
 --------------------------------------------------
 // KIBANA
 
@@ -119,7 +119,7 @@ Import a visualization and dashboard with an index pattern for the visualization
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_import" -H "kbn-xsrf: true" --form file=@file.ndjson
+$ curl -X POST api/saved_objects/_import -H "kbn-xsrf: true" --form file=@file.ndjson
 --------------------------------------------------
 // KIBANA
 
diff --git a/docs/api/saved-objects/resolve_import_errors.asciidoc b/docs/api/saved-objects/resolve_import_errors.asciidoc
index ec03917390d3..03c116c39dd8 100644
--- a/docs/api/saved-objects/resolve_import_errors.asciidoc
+++ b/docs/api/saved-objects/resolve_import_errors.asciidoc
@@ -63,7 +63,7 @@ Retry a dashboard import:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_resolve_import_errors" -H "kbn-xsrf: true" --form file=@file.ndjson --form retries='[{"type":"dashboard","id":"my-dashboard"}]'
+$ curl -X POST api/saved_objects/_resolve_import_errors -H "kbn-xsrf: true" --form file=@file.ndjson --form retries='[{"type":"dashboard","id":"my-dashboard"}]'
 --------------------------------------------------
 // KIBANA
 
@@ -88,7 +88,7 @@ Resolve errors for a dashboard and overwrite the existing saved object:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_resolve_import_errors" -H "kbn-xsrf: true" --form file=@file.ndjson --form retries='[{"type":"dashboard","id":"my-dashboard","overwrite":true}]'
+$ curl -X POST api/saved_objects/_resolve_import_errors -H "kbn-xsrf: true" --form file=@file.ndjson --form retries='[{"type":"dashboard","id":"my-dashboard","overwrite":true}]'
 --------------------------------------------------
 // KIBANA
 
@@ -114,7 +114,7 @@ Resolve errors for a visualization by replacing the index pattern with another:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/saved_objects/_resolve_import_errors" -H "kbn-xsrf: true" --form file=@file.ndjson --form retries='[{"type":"visualization","id":"my-vis","replaceReferences":[{"type":"index-pattern","from":"missing","to":"existing"}]}]'
+$ curl -X POST api/saved_objects/_resolve_import_errors -H "kbn-xsrf: true" --form file=@file.ndjson --form retries='[{"type":"visualization","id":"my-vis","replaceReferences":[{"type":"index-pattern","from":"missing","to":"existing"}]}]'
 --------------------------------------------------
 // KIBANA
 
diff --git a/docs/api/saved-objects/update.asciidoc b/docs/api/saved-objects/update.asciidoc
index 62f4104debc7..3d9edd9369ad 100644
--- a/docs/api/saved-objects/update.asciidoc
+++ b/docs/api/saved-objects/update.asciidoc
@@ -49,7 +49,7 @@ Update an existing index pattern object,`my-pattern`, with a different title:
 
 [source,sh]
 --------------------------------------------------
-$ curl -X PUT "localhost:5601/api/saved_objects/index-pattern/my-pattern"
+$ curl -X PUT api/saved_objects/index-pattern/my-pattern
 {
   "attributes": {
     "title": "some-other-pattern-*"
diff --git a/docs/api/spaces-management/copy_saved_objects.asciidoc b/docs/api/spaces-management/copy_saved_objects.asciidoc
index 4822e7f62430..d39b1e134c9d 100644
--- a/docs/api/spaces-management/copy_saved_objects.asciidoc
+++ b/docs/api/spaces-management/copy_saved_objects.asciidoc
@@ -96,7 +96,7 @@ Copy a dashboard with the `my-dashboard` ID, including all references from the `
 
 [source,sh]
 ----
-$ curl -X POST "localhost:5601/api/spaces/_copy_saved_objects"
+$ curl -X POST api/spaces/_copy_saved_objects
 {
   "objects": [{
     "type": "dashboard",
@@ -137,7 +137,7 @@ Copy a visualization with the `my-viz` ID from the `marketing` space to the `def
 
 [source,sh]
 ----
-$ curl -X POST "localhost:5601/s/marketing/api/spaces/_copy_saved_objects"
+$ curl -X POST s/marketing/api/spaces/_copy_saved_objects
 {
   "objects": [{
     "type": "visualization",
diff --git a/docs/api/spaces-management/post.asciidoc b/docs/api/spaces-management/post.asciidoc
index b96fbe6364c3..1abfffd1c736 100644
--- a/docs/api/spaces-management/post.asciidoc
+++ b/docs/api/spaces-management/post.asciidoc
@@ -47,7 +47,7 @@ experimental[] Create a {kib} space.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/spaces/space"
+$ curl -X POST api/spaces/space
 {
   "id": "marketing",
   "name": "Marketing",
diff --git a/docs/api/spaces-management/put.asciidoc b/docs/api/spaces-management/put.asciidoc
index f405d57975a7..e8f75ee089d7 100644
--- a/docs/api/spaces-management/put.asciidoc
+++ b/docs/api/spaces-management/put.asciidoc
@@ -47,7 +47,7 @@ experimental[] Update an existing {kib} space.
 
 [source,sh]
 --------------------------------------------------
-$ curl -X PUT "localhost:5601/api/spaces/space/marketing"
+$ curl -X PUT api/spaces/space/marketing
 {
   "id": "marketing",
   "name": "Marketing",
diff --git a/docs/api/spaces-management/resolve_copy_saved_objects_conflicts.asciidoc b/docs/api/spaces-management/resolve_copy_saved_objects_conflicts.asciidoc
index 565d12513815..6c10ae9046ca 100644
--- a/docs/api/spaces-management/resolve_copy_saved_objects_conflicts.asciidoc
+++ b/docs/api/spaces-management/resolve_copy_saved_objects_conflicts.asciidoc
@@ -116,7 +116,7 @@ Overwrite an index pattern in the `marketing` space, and a visualization in the
 
 [source,sh]
 ----
-$ curl -X POST "localhost:5601/api/spaces/_resolve_copy_saved_objects_errors"
+$ curl -X POST api/spaces/_resolve_copy_saved_objects_errors
 {
   "objects": [{
     "type": "dashboard",
diff --git a/docs/api/upgrade-assistant/batch_reindexing.asciidoc b/docs/api/upgrade-assistant/batch_reindexing.asciidoc
index 40b6d9c816d5..db3e080d0918 100644
--- a/docs/api/upgrade-assistant/batch_reindexing.asciidoc
+++ b/docs/api/upgrade-assistant/batch_reindexing.asciidoc
@@ -32,7 +32,7 @@ are consumed over time.
 
 [source,js]
 --------------------------------------------------
-POST /api/upgrade_assistant/reindex/batch
+$ curl -X POST api/upgrade_assistant/reindex/batch
 {
   "indexNames": [ <1>
     "index1",
@@ -40,7 +40,9 @@ POST /api/upgrade_assistant/reindex/batch
   ]
 }
 --------------------------------------------------
-<1> The order in which the indices are provided here determines the order in which the reindex tasks will be executed.
+// KIBANA
+
+<1> The order of the indices determines the order that the reindex tasks are executed.
 
 Similar to the <<start-resume-reindex, start or resume endpoint>>, the API returns the following:
 
diff --git a/docs/api/upgrade-assistant/check_reindex_status.asciidoc b/docs/api/upgrade-assistant/check_reindex_status.asciidoc
index 00801f201d1e..98cf263673f7 100644
--- a/docs/api/upgrade-assistant/check_reindex_status.asciidoc
+++ b/docs/api/upgrade-assistant/check_reindex_status.asciidoc
@@ -64,6 +64,7 @@ The API returns the following:
 
 `3`::
   Paused
++
 NOTE: If the {kib} node that started the reindex is shutdown or restarted, the reindex goes into a paused state after some time.
 To resume the reindex, you must submit a new POST request to the `/api/upgrade_assistant/reindex/<indexName>` endpoint.
 
diff --git a/docs/api/url-shortening.asciidoc b/docs/api/url-shortening.asciidoc
index a62529e11a9b..ffe1d925e5dc 100644
--- a/docs/api/url-shortening.asciidoc
+++ b/docs/api/url-shortening.asciidoc
@@ -1,5 +1,5 @@
 [[url-shortening-api]]
-=== Shorten URL API
+== Shorten URL API
 ++++
 <titleabbrev>Shorten URL</titleabbrev>
 ++++
@@ -9,34 +9,39 @@ Internet Explorer has URL length restrictions, and some wiki and markup parsers
 
 Short URLs are designed to make sharing {kib} URLs easier.
 
+[float]
 [[url-shortening-api-request]]
-==== Request
+=== Request
 
 `POST <kibana host>:<port>/api/shorten_url`
 
+[float]
 [[url-shortening-api-request-body]]
-==== Request body
+=== Request body
 
 `url`::
   (Required, string) The {kib} URL that you want to shorten, relative to `/app/kibana`.
 
+[float]
 [[url-shortening-api-response-body]]
-==== Response body
+=== Response body
 
 urlId:: A top-level property that contains the shortened URL token for the provided request body.
 
+[float]
 [[url-shortening-api-codes]]
-==== Response code
+=== Response code
 
 `200`::
   Indicates a successful call.
 
+[float]
 [[url-shortening-api-example]]
-==== Example
+=== Example
 
 [source,sh]
 --------------------------------------------------
-$ curl -X POST "localhost:5601/api/shorten_url"
+$ curl -X POST api/shorten_url
 {
   "url": "/app/kibana#/dashboard?_g=()&_a=(description:'',filters:!(),fullScreenMode:!f,options:(hidePanelTitles:!f,useMargins:!t),panels:!((embeddableConfig:(),gridData:(h:15,i:'1',w:24,x:0,y:0),id:'8f4d0c00-4c86-11e8-b3d7-01146121b73d',panelIndex:'1',type:visualization,version:'7.0.0-alpha1')),query:(language:lucene,query:''),timeRestore:!f,title:'New%20Dashboard',viewMode:edit)"
 }
diff --git a/docs/api/using-api.asciidoc b/docs/api/using-api.asciidoc
index e58d9c39ee8c..188c8f9a5909 100644
--- a/docs/api/using-api.asciidoc
+++ b/docs/api/using-api.asciidoc
@@ -31,7 +31,7 @@ For example, the following `curl` command exports a dashboard:
 
 [source,sh]
 --
-curl -X POST -u $USER:$PASSWORD "localhost:5601/api/kibana/dashboards/export?dashboard=942dcef0-b2cd-11e8-ad8e-85441f0c2e5c"
+curl -X POST api/kibana/dashboards/export?dashboard=942dcef0-b2cd-11e8-ad8e-85441f0c2e5c
 --
 // KIBANA