@@ -42,8 +42,9 @@ func resourceAwsApiGatewayApiKey() *schema.Resource {
 			},
 
 			"stage_key": {
-				Type:     schema.TypeSet,
-				Optional: true,
+				Type:       schema.TypeSet,
+				Optional:   true,
+				Deprecated: "Since the API Gateway usage plans feature was launched on August 11, 2016, usage plans are now required to associate an API key with an API stage",
 				Elem: &schema.Resource{
 					Schema: map[string]*schema.Schema{
 						"rest_api_id": {
 
@@ -10,6 +10,8 @@ description: |-
 
 Provides an API Gateway API Key.
 
+~> **Warning:** Since the API Gateway usage plans feature was launched on August 11, 2016, usage plans are now **required** to associate an API key with an API stage.
+
 ## Example Usage
 
 ```