CIPP icon

CIPP

CIPP-API is an Azure Function App providing the logic layer for the CIPP platform. This spec is auto-generated via static analysis of both the API (PowerShell) and frontend (React/Next.js) repositories. Last generated: 2026-03-02.

Actions75

TenantGDAP → ExecGDAPRoleTemplate

AI-generated

Overview

This node interacts with the TenantGDAP resource to perform operations related to GDAP (Granular Delegated Admin Privileges) role templates. Specifically, the ExecGDAPRoleTemplate operation allows users to delete a GDAP role template via the API endpoint DELETE /api/ExecGDAPRoleTemplate. This is useful for managing and cleaning up GDAP role templates in a tenant environment, ensuring that outdated or unnecessary role templates can be removed programmatically.

Use Case Examples

  1. Deleting a specific GDAP role template by providing its template ID and related details to maintain tenant security and role management.
  2. Automating the cleanup of GDAP role templates as part of a tenant administration workflow.

Properties

Name Meaning
Action The action to perform related to the GDAP role template.
TemplateId The identifier of the GDAP role template to be deleted or managed.
GdapTemplate The GDAP template details in JSON format, used for selection or autocomplete in the UI.
GroupId The group identifier associated with the GDAP role template.
InviteCount The count of invites related to the GDAP role template.
OriginalTemplateId The original template ID if the role template is a derivative or copy.
Reference A reference string for additional context or identification.
RoleMappings Role mappings in JSON format, representing the mapping of roles within the GDAP template.

Output

JSON

  • json - The JSON response from the API call, containing the result of the delete operation or other relevant data.

Dependencies

  • An API key credential for authenticating with the CIPP API

Troubleshooting

  • Ensure the API key credential is correctly configured and has the necessary permissions to delete GDAP role templates.
  • Verify that the TemplateId provided is correct and exists in the tenant environment.
  • Check for network connectivity issues or API endpoint availability.
  • Enable debug mode to see the actual request URL, headers, and body for troubleshooting.

Discussion