Permissions & Sharing

from docent import Docent

client = Docent()

has_write = client.has_collection_permission("my-collection-id", "write")
print(f"Has write access: {has_write}")

# Make publicly readable
client.share_collection_with_public("my-collection-id", permission="read")

# Remove public access
client.unshare_collection_with_public("my-collection-id")

client.share_collection_with_email("my-collection-id", "[email protected]")

# Grant read access
client.share_collection_with_user("my-collection-id", "user-456", permission="read")

# Grant write access
client.share_collection_with_user("my-collection-id", "user-456", permission="write")

# Remove access
client.unshare_collection_with_user("my-collection-id", "user-456")

client.share_collection_with_organization(
    "my-collection-id",
    "org-789",
    permission="read",
)

# Remove organization access
client.unshare_collection_with_organization("my-collection-id", "org-789")

orgs = client.get_my_organizations()
for org in orgs:
    print(f"{org['id']}: {org['name']}")

users = client.get_organization_users("org-789")
for user in users:
    print(f"{user['id']}: {user.get('email')}")

collaborators = client.get_collection_collaborators("my-collection-id")
for c in collaborators:
    print(f"{c['subject_type']}/{c['subject_id']}: {c['permission_level']}")