From 774e1f899e5dd4df1c98d2260eb704cbbf42c5bd Mon Sep 17 00:00:00 2001
From: Samantha Blanco <samantha.blanco@att.com>
Date: Wed, 21 Dec 2016 10:50:54 -0500
Subject: [PATCH] Update response code descriptions in API spec

Change-Id: I61ff85e78f5be340755097000a0cd2002e91b0e4
Closes-Bug: #1627725
---
 .../articles/specification/murano-api.rst        | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/doc/source/appendix/articles/specification/murano-api.rst b/doc/source/appendix/articles/specification/murano-api.rst
index f6004ac4a..4d56f8b0b 100644
--- a/doc/source/appendix/articles/specification/murano-api.rst
+++ b/doc/source/appendix/articles/specification/murano-api.rst
@@ -807,11 +807,11 @@ should use next endpoint: */environments/<env_id>/services/<application_id>/name
         }
     }
 
-POST applications
------------------
+Create new application
+----------------------
 
-New application can be added to the murano environment using session.
-Result JSON is calculated in Murano dashboard, which based on `UI definition <Dynamic UI Spec>`_
+Create a new application and add it to the murano environment.
+Result JSON is calculated in Murano dashboard, which is based on `UI definition <https://git.openstack.org/cgit/openstack/murano/tree/doc/source/appdev-guide/muranopackages/dynamic_ui.rst>`_.
 
 *Request*
 
@@ -880,13 +880,13 @@ Created application returned
 +----------------+-----------------------------------------------------------+
 | Code           | Description                                               |
 +================+===========================================================+
-| 200            | Session is deleted successfully                           |
+| 200            | Application was created successfully                      |
 +----------------+-----------------------------------------------------------+
-| 401            | User is not authorized to access this session             |
+| 401            | User is not authorized to perform this action             |
 +----------------+-----------------------------------------------------------+
-| 403            | Session is in deploying state and could not be deleted    |
+| 403            | Policy prevents this user from performing this action     |
 +----------------+-----------------------------------------------------------+
-| 404            | Not found. Specified session doesn`t exist                |
+| 404            | Not found. Environment doesn't exist                      |
 +----------------+-----------------------------------------------------------+
 | 400            | Required header or body are not provided                  |
 +----------------+-----------------------------------------------------------+