Add book access for a user.
Use an administrator account to grant another active user in the same organisation access to a book the
caller can access. A view-only target can receive only View access. A matching-name book already
linked to the target, or an identical existing grant, is rejected. The grant is applied before returning in
the normal result envelope.
Authorizations
OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header
Body
Required ProxyUserEmail for another active same-organisation user, BookName for a book available to the caller, and AccessType: View (1), Edit (2), Full (3), or Owner (4).
Target user, book, and access level selected for a new book grant.
Derivitec.Web.Core.BookAccess.ApiProxyUserBookAccessCreateRequest, Derivitec.Web.Core Email address of the organisation user whose book access is being changed.
"user@example.com"
Organisation-scoped name of the book to select. The value must not be null or empty.
"Example book"
Book access level to grant to the selected user.
view, edit, full, owner Response
Created
Outcome of granting a user access to a book.
Derivitec.Web.Core.BookAccess.ApiProxyUserBookAccessCreateResponse, Derivitec.Web.Core Whether the operation completed successfully. The default is true; error outcomes set it to false.
true
Messages explaining operation-level failures. The collection is empty by default.