Tools reference/Permissions

Resource permissions

Access can be given to a person or a team on a workspace, project, folder, document, work item or plan: read, write or admin, or none to deny it. On a project, access to documents, work items and plans can each be set to inherit, allow or deny. Nobody can use these tools to give themselves, or the person they act for, more than that person already has.

The live list

Your AI tool can call searchTools with category: "permissions" for the current list of these tools with every input. This page is the readable copy.

The tools

Every tool below keeps to the access of the key or sign-in that calls it, and to the person’s own role. A tool only sees the tools it may use.

  • deleteResourcePermission

    Revoke a permission.

  • getEffectivePermission

    Resolve the effective permission for a user on a resource (with source).

  • listResourcePermissions

    List permissions on a resource.

  • setResourcePermissionOverride

    Set a 3-state inheritance override (documents / improvements / plans).

  • updateResourcePermission

    Update an existing permission's level.

  • upsertResourcePermission

    Grant or update a permission. Principal is user XOR team.