CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node operation allows editing calendar permissions for a specified user within a tenant. It is useful for managing access control to calendar folders, such as granting or removing permissions for users to view or edit calendar events. Practical examples include setting a user's permission level to 'Editor' to allow event modifications or removing a user's access entirely.

Use Case Examples

  1. Granting 'Editor' permission to a user for a shared calendar folder named 'Calendar'.
  2. Removing a user's access to a calendar and optionally sending a notification about the change.

Properties

Name Meaning
User ID The email address or ID of the user whose calendar permissions are being managed.
Tenant Filter The tenant ID or domain name to filter the user within the tenant context.
Permissions The level of calendar access to assign to the user, such as Author, Editor, or Reviewer.
User to Get Permissions The email address or ID of the user whose calendar permissions are being retrieved or updated.
Folder Name The name of the calendar folder to which the permissions apply, defaulting to 'Calendar'.
Remove Access Boolean flag to remove the user's access to the calendar.
Send Notification to User Boolean flag to send a notification to the user about the permission change.
Request Options Additional request settings such as batching, SSL handling, proxy, and timeout configurations.

Output

JSON

  • success - Indicates if the permission update operation was successful.
  • updatedPermissions - Details of the updated calendar permissions for the user.

Dependencies

  • Requires an API key credential for authentication to the CIPP API service.

Troubleshooting

  • Ensure the User ID and Tenant Filter are correctly specified to avoid permission update failures.
  • Check that the API credentials are valid and have sufficient rights to modify calendar permissions.
  • If removing access, verify that the user actually has existing permissions to avoid errors.
  • Timeouts may occur if the server is slow; adjust the timeout setting in request options if needed.

Links

Discussion