From 5c0726f38c15fab3640dd86c8dcf3d54b757c58b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mike=20C=C3=B4t=C3=A9?= <mikecote@users.noreply.github.com>
Date: Tue, 23 Feb 2021 11:12:47 -0500
Subject: [PATCH] Add docs for ability to specify custom alert ids (#92410)

* Add docs for ability to specify custom alert ids

* Add v1/v4
---
 docs/api/alerts/create.asciidoc | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/api/alerts/create.asciidoc b/docs/api/alerts/create.asciidoc
index 9e188b971c9b5..996503bc59148 100644
--- a/docs/api/alerts/create.asciidoc
+++ b/docs/api/alerts/create.asciidoc
@@ -9,7 +9,13 @@ Create {kib} alerts.
 [[alerts-api-create-request]]
 ==== Request
 
-`POST <kibana host>:<port>/api/alerts/alert`
+`POST <kibana host>:<port>/api/alerts/alert/<id>`
+
+[[alerts-api-create-path-params]]
+==== Path parameters
+
+`<id>`::
+  (Optional, string) Specifies a UUID v1 or v4 to use instead of a randomly generated ID.
 
 [[alerts-api-create-request-body]]
 ==== Request body