diff --git a/docs/source/development/api.rst b/docs/source/development/api.rst
index f895be089..012178cbe 100644
--- a/docs/source/development/api.rst
+++ b/docs/source/development/api.rst
@@ -123,9 +123,9 @@ Index:
    Path: :code:`/api/1.0/person/accompanying-period/origin.{_format}`
 
 Entity:
-   Name: :code:`chill_api_single_accompanying_period_origin__index`
+   Name: :code:`chill_api_single_accompanying_period_origin__entity`
 
-   Path: :code:`/api/1.0/person/accompanying-period/origin.{_format}`
+   Path: :code:`/api/1.0/person/accompanying-period/origin/{id}.{_format}`
 
 Role
 ====
@@ -134,7 +134,7 @@ By default, the key `base_role` is used to check ACL. Take care of creating the
 
 For index action, the role will be called with :code:`NULL` as :code:`$subject`. The retrieved entity will be the subject for single queries.
 
-You can also define a role for each method:
+You can also define a role for each method. In this case, this role is used for the given method, and, if any, the base role is taken into account.
 
 .. code-block:: yaml