diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 3dbe7bbe0..66f6ec049 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -501,10 +501,12 @@ request_id_body:
   type: string
 restart_policy:
   description: |
-    Restart policy to apply when a container exits. Allowed values are
-    no, on-failure[:max-retry], always, unless-stopped.
+    Restart policy to apply when a container exits. It must contain a
+    ``Name`` key and its allowed values are ``no``, ``on-failure``, ``always``,
+    ``unless-stopped``. Optionally, it can contain a ``MaximumRetryCount`` key
+    and its value is an integer.
   in: body
-  type: string
+  type: object
 runtime:
   description: |
     The container runtime tool to create container with. You can use