Remove one sharing grant from a post
DELETE /posts/{id}/acls/{principal_type}/{principal_id}/{permission}
Removes one grant from a post: the one with exactly this principal type, principal id and level. Other grants, including other levels for the same user, stay.
You need to be signed in. The post’s author, holders of
posts.admin or system.admin granted globally, and holders of
posts.admin for the post’s team can remove grants. Others get 403;
a post that doesn’t exist or is deleted is 404. When no grant
matches exactly, the answer is 404, including on a second request.
The path values are matched as stored rather than checked, so an
expired grant or an old role or team grant can be removed this
way, and a user ref must be written as it was stored: 1 doesn’t
remove a grant stored as 001.
Removing a grant takes away only what that grant gave. The user can still read the post if its visibility or another rule lets them, and anything they already downloaded stays with them. They aren’t notified.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The post’s id.
The principal type of the grant to remove, as listed.
The principal id of the grant to remove, exactly as listed.
The level of the grant to remove, as listed.
Responses
Section titled “ Responses ”The grant was removed.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completed