diff --git a/rest-api/api-docs/channels.json b/rest-api/api-docs/channels.json
index 0f3b8e20e6..b408d8b173 100644
--- a/rest-api/api-docs/channels.json
+++ b/rest-api/api-docs/channels.json
@@ -20,6 +20,7 @@
 				{
 					"httpMethod": "POST",
 					"summary": "Create a new channel (originate).",
+					"notes": "The new channel is not created until the dialed party picks up. Not wanting to block this request indefinitely, this request returns immediately with a 204 No Content. When the channel is created, a StasisStart event is sent with the provided app and appArgs. In the event of a failure (timeout, busy, etc.), an OriginationFailed event is sent.",
 					"nickname": "originate",
 					"responseClass": "void",
 					"parameters": [