---
title: "PATCH /calendars/{calendarId}/acl/{ruleId}"
method: PATCH
path: "/calendars/{calendarId}/acl/{ruleId}"
tags: ["acl"]
---

# PATCH /calendars/{calendarId}/acl/{ruleId}

`PATCH /calendars/{calendarId}/acl/{ruleId}`

Updates an access control rule. This method supports patch semantics.

## Path parameters

- `calendarId` string, required
- `ruleId` string, required

## Query parameters

- `sendNotifications` boolean

## Request body

- AclRule
  - `id` string — Identifier of the Access Control List (ACL) rule. See Sharing calendars.
  - `role` string — The role assigned to the scope. Possible values are: - "none" - Provides no access. - "freeBusyReader" - Provides read access to free/busy information. - "reader" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - "writerWithoutPrivateAccess" - Provides read and write access to the calendar. Private events will appear to users with writerWithoutPrivateAccess access, but event details will be hidden. - "writer" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. Provides read access to the calendar's ACLs. - "owner" - Provides manager access to the calendar. This role has all of the permissions of the writer role with the additional ability to modify access levels of other users. Important: the owner role is different from the calendar's data owner. A calendar has a single data owner, but can have multiple users with owner role.
  - `etag` string — ETag of the resource.
  - `kind` string — Type of the resource ("calendar#aclRule").
  - `scope` object — The extent to which calendar access is granted by this ACL rule.
    - `type` string — The type of the scope. Possible values are: - "default" - The public scope. This is the default value. - "user" - Limits the scope to a single user. - "group" - Limits the scope to a group. - "domain" - Limits the scope to a domain. Note: The permissions granted to the "default", or public, scope apply to any user, authenticated or not.
    - `value` string — The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type "default".

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/calendar.md) · [All operations](https://skmtc.net/google/apis/calendar/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/calendar/revisions/8a9c54b56c55/schema)