List who a post is shared with
GET /posts/{id}/acls
Lists every sharing grant stored on a post: who it names, the level, when it was last granted and by whom, and when it expires.
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 see the list. Being able to
read the post, or having it shared with you, isn’t enough. Others
get 403; a post that doesn’t exist or is deleted is 404.
Every stored grant is listed, including expired ones and old role
or team grants, which give no access, most recently granted first,
with no paging. Only a user grant that hasn’t expired lets someone
read the post, and the level makes no difference. Sharing doesn’t
publish a draft: while the post is a draft, a grant can let in only
a holder of posts.admin or system.admin granted globally.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The post’s id.
Responses
Section titled “ Responses ”The grants stored on the post.
object
Who the grant is for, as stored: a user’s numeric ref, or a role’s
or team’s UUID.
When the grant was last written. Granting the same principal and level again resets it.
The ref of the account that last wrote the grant, or null if none is recorded.
When the grant stops giving access, or null if it doesn’t expire.
A grant whose time has been reached is still stored and listed, but
gives no access.
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