# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1581520247 0
# Node ID 2b494b8ff72d6bf1a7848eab5f7d7f40af846e87
# Parent  8a9b2efa92aa4162f04b43b55c3e5f2341b83420
Documented the "Entry exists" error in the API.

diff --git a/xml/en/docs/http/ngx_http_api_module.xml b/xml/en/docs/http/ngx_http_api_module.xml
--- a/xml/en/docs/http/ngx_http_api_module.xml
+++ b/xml/en/docs/http/ngx_http_api_module.xml
@@ -1053,6 +1053,7 @@ upstream “<value>name</value>” memory exhausted (<literal>UpstreamOutOfMemory</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>404 - Unknown version (<literal>UnknownVersion</literal>),
 upstream not found (<literal>UpstreamNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>405 - Method disabled (<literal>MethodDisabled</literal>), returns <link id="def_nginx_error">Error</link></listitem>
+<listitem>409 - Entry exists (<literal>EntryExists</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
@@ -1240,7 +1241,8 @@ reading request body failed <literal>Bod
 <listitem>404 - Keyval not found (<literal>KeyvalNotFound</literal>),
 unknown version (<literal>UnknownVersion</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>405 - Method disabled (<literal>MethodDisabled</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-<listitem>409 - Key already exists (<literal>KeyvalKeyExists</literal>), returns <link id="def_nginx_error">Error</link></listitem>
+<listitem>409 - Entry exists (<literal>EntryExists</literal>),
+key already exists (<literal>KeyvalKeyExists</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>413 - Request Entity Too Large, returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
@@ -1607,6 +1609,7 @@ reading request body failed <literal>Bod
 <listitem>404 - Unknown version (<literal>UnknownVersion</literal>),
 upstream not found (<literal>UpstreamNotFound</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>405 - Method disabled (<literal>MethodDisabled</literal>), returns <link id="def_nginx_error">Error</link></listitem>
+<listitem>409 - Entry exists (<literal>EntryExists</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
 </listitem>
@@ -1794,7 +1797,8 @@ reading request body failed <literal>Bod
 <listitem>404 - Keyval not found (<literal>KeyvalNotFound</literal>),
 unknown version (<literal>UnknownVersion</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>405 - Method disabled (<literal>MethodDisabled</literal>), returns <link id="def_nginx_error">Error</link></listitem>
-<listitem>409 - Key already exists (<literal>KeyvalKeyExists</literal>), returns <link id="def_nginx_error">Error</link></listitem>
+<listitem>409 - Entry exists (<literal>EntryExists</literal>),
+key already exists (<literal>KeyvalKeyExists</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>413 - Request Entity Too Large, returns <link id="def_nginx_error">Error</link></listitem>
 <listitem>415 - JSON error (<literal>JsonError</literal>), returns <link id="def_nginx_error">Error</link></listitem>
 </list>
diff --git a/yaml/nginx_api.yaml b/yaml/nginx_api.yaml
--- a/yaml/nginx_api.yaml
+++ b/yaml/nginx_api.yaml
@@ -896,6 +896,10 @@ paths:
           description: Method disabled (*MethodDisabled*)
           schema:
             $ref: '#/definitions/NginxError'
+        '409':
+          description: Entry exists (*EntryExists*)
+          schema:
+            $ref: '#/definitions/NginxError'
         '415':
           description: JSON error (*JsonError*)
           schema:
@@ -1145,7 +1149,9 @@ paths:
           schema:
             $ref: '#/definitions/NginxError'
         '409':
-          description: Key already exists (*KeyvalKeyExists*)
+          description: |
+            Entry exists (*EntryExists*),
+            key already exists (*KeyvalKeyExists*)
           schema:
             $ref: '#/definitions/NginxError'
         '413':
@@ -1602,6 +1608,10 @@ paths:
           description: Method disabled (*MethodDisabled*)
           schema:
             $ref: '#/definitions/NginxError'
+        '409':
+          description: Entry exists (*EntryExists*)
+          schema:
+            $ref: '#/definitions/NginxError'
         '415':
           description: JSON error (*JsonError*)
           schema:
@@ -1851,7 +1861,9 @@ paths:
           schema:
             $ref: '#/definitions/NginxError'
         '409':
-          description: Key already exists (*KeyvalKeyExists*)
+          description: |
+            Entry exists (*EntryExists*),
+            key already exists (*KeyvalKeyExists*)
           schema:
             $ref: '#/definitions/NginxError'
         '413':