[arvados] created: 2.5.0-81-gc3cea0c56

[git repository hosting]

        at  c3cea0c565585e089f571545fcbf28ee4e703671 (commit)


commit c3cea0c565585e089f571545fcbf28ee4e703671
Author: Tom Clegg <tom at curii.com>
Date:   Wed Feb 1 13:34:51 2023 -0500

    19954: Update API docs to reflect permission link deduplication.
    
    Arvados-DCO-1.1-Signed-off-by: Tom Clegg <tom at curii.com>

diff --git a/doc/api/methods/links.html.textile.liquid b/doc/api/methods/links.html.textile.liquid
index eceea296d..04be591a0 100644
--- a/doc/api/methods/links.html.textile.liquid
+++ b/doc/api/methods/links.html.textile.liquid
@@ -37,7 +37,11 @@ Some classes are pre-defined by convention and have standard meanings attached t
 
 h3. permission
 
-See "permission links":{{site.baseurl}}/api/permission-model.html#links section of the permission model.
+The significance of permission links is discussed in the "permission links":{{site.baseurl}}/api/permission-model.html#links section of the permission model documentation.
+
+Permission links are transparently de-duplicated during create/update/delete operations. As a result these API methods have slightly different semantics.
+* When requesting to create a new permission link, the API may respond with an existing permission link that had the same @head_uuid@ and @tail_uuid@, rather than creating a new one. If the requested permission level is higher than the existing permission link, the existing link will be updated accordingly. Otherwise the existing link will be returned unchanged.
+* When deleting a permission link, any other existing links that have the same @head_uuid@ and @tail_uuid@ are also deleted.
 
 h3. star
 

-----------------------------------------------------------------------


hooks/post-receive
--