diff --git a/doc/api_samples/os-scheduler-hints/scheduler-hints-post-req.json b/doc/api_samples/os-scheduler-hints/scheduler-hints-post-req.json
new file mode 100644
index 000000000..3e437e63f
--- /dev/null
+++ b/doc/api_samples/os-scheduler-hints/scheduler-hints-post-req.json
@@ -0,0 +1,11 @@
+{
+    "server": {
+        "name": "new-server-test",
+        "imageRef": "70a599e0-31e7-49b7-b260-868f441e862b",
+        "flavorRef": "1"
+    },
+    "os:scheduler_hints": {
+        "hypervisor": "xen",
+        "near": "2b7c42eb-7736-4a0f-afab-f23969a35ada"
+    }
+}
\ No newline at end of file
diff --git a/doc/api_samples/os-scheduler-hints/scheduler-hints-post-req.xml b/doc/api_samples/os-scheduler-hints/scheduler-hints-post-req.xml
new file mode 100644
index 000000000..079289de0
--- /dev/null
+++ b/doc/api_samples/os-scheduler-hints/scheduler-hints-post-req.xml
@@ -0,0 +1,10 @@
+<server
+        name='new-server-test'
+        imageRef='70a599e0-31e7-49b7-b260-868f441e862b'
+        flavorRef='1'
+>
+        <scheduler_hints>
+                <hypervisor>xen</hypervisor>
+                <near>eb999657-dd6b-464e-8713-95c532ac3b18</near>
+        </scheduler_hints>
+</server>
\ No newline at end of file
diff --git a/doc/api_samples/os-scheduler-hints/scheduler-hints-post-resp.json b/doc/api_samples/os-scheduler-hints/scheduler-hints-post-resp.json
new file mode 100644
index 000000000..cc3a87316
--- /dev/null
+++ b/doc/api_samples/os-scheduler-hints/scheduler-hints-post-resp.json
@@ -0,0 +1,16 @@
+{
+    "server": {
+        "adminPass": "yjzytFHb7XHc",
+        "id": "f8f4f3ce-f6e0-4e05-8f79-bf984fdfce45",
+        "links": [
+            {
+                "href": "http://openstack.example.com/v2/openstack/servers/f8f4f3ce-f6e0-4e05-8f79-bf984fdfce45",
+                "rel": "self"
+            },
+            {
+                "href": "http://openstack.example.com/openstack/servers/f8f4f3ce-f6e0-4e05-8f79-bf984fdfce45",
+                "rel": "bookmark"
+            }
+        ]
+    }
+}
\ No newline at end of file
diff --git a/doc/api_samples/os-scheduler-hints/scheduler-hints-post-resp.xml b/doc/api_samples/os-scheduler-hints/scheduler-hints-post-resp.xml
new file mode 100644
index 000000000..59929d808
--- /dev/null
+++ b/doc/api_samples/os-scheduler-hints/scheduler-hints-post-resp.xml
@@ -0,0 +1,6 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<server xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://docs.openstack.org/compute/api/v1.1" id="a14a9bf5-93b3-49e4-85f1-01d7cf2645b4" adminPass="Q6jfHPrnvB9X">
+  <metadata/>
+  <atom:link href="http://openstack.example.com/v2/openstack/servers/a14a9bf5-93b3-49e4-85f1-01d7cf2645b4" rel="self"/>
+  <atom:link href="http://openstack.example.com/openstack/servers/a14a9bf5-93b3-49e4-85f1-01d7cf2645b4" rel="bookmark"/>
+</server>
\ No newline at end of file