diff --git a/core/core.api.php b/core/core.api.php
old mode 100755
new mode 100644
index 85fc6542f5b7401ffc9172d8573b218665fde856..9a625d03a149f0fb6722f65652416102dbd26200
--- a/core/core.api.php
+++ b/core/core.api.php
@@ -90,10 +90,12 @@
  * returned response) for its HTTP requests. REST requests are separated into
  * several types, known as methods, including:
  * - GET: Requests to obtain data.
- * - PUT: Requests to update or create data.
+ * - POST: Requests to update or create data.
+ * - PUT: Requests to update or create data (limited support, currently unused
+ *   by entity resources).
  * - PATCH: Requests to update a subset of data, such as one field.
  * - DELETE: Requests to delete data.
- * The Drupal Core REST module provides support for GET, PUT, PATCH, and DELETE
+ * The Drupal Core REST module provides support for GET, POST, PATCH, and DELETE
  * quests on entities, GET requests on the database log from the Database
  * Logging module, and a plugin framework for providing REST support for other
  * data and other methods.