AI Actions: roles and permissions

NOTE: this page was reviewed using Contentful's AI Actions "Review" and "Fix Spelling & Grammar" templates to support clarity and accuracy.

AI Actions roles and permissions in Contentful are managed at the space level, allowing admins to select which users who can create, edit or invoke an action. This ensures that AI-driven content automation aligns with your organization’s governance policies. Below is a breakdown of the different role and permission preferences for managing AI Actions.

Set up AI Actions 

You can grant the appropriate space roles within your organization the ability to create, modify and invoke AI Actions on a per space basis.

ai-actions-roles-and-permissions

To set up AI Actions permissions: 

  1. In the “Settings menu,” choose Roles & Permissions under “Environment settings” section in the dropdown.  

  2. Choose the role in your space you want to grant permissions. 

  3. Click on the triple dotted icon, and choose Edit. 

  4. Navigate to the AI Actions section under the “Permissions” tab for the role. 

  5. Adjust the toggle and choose: Invoke AI Actions, Create and modify AI Actions, or both depending on the role. 

  6. Click Save Changes at the top right corner.  

Roles and Permission types

Create and Edit AI Actions

Only space and org admins can create and configure AI Actions by default. This means admins can grant other space roles the ability to invoke, create and modify AI Actions through the Roles & Permissions settings.

If you do not see the option to create or update AI Actions, contact your space admin to request permission.

Invoke AI Actions

Invoking an AI Action allows users to trigger AI Actions within the entry editor. By default, only admins can invoke AI Actions. If editors or other roles need access, space admins must enable invoke permissions in the Roles & Permissions settings.

  • If an editor attempts to invoke an AI Action without permission, they will see a restricted access message.

  • Admins can selectively invoke access to specific roles, ensuring control over how the AI interacts with your content.

Publish and Unpublish AI Actions

To publish or unpublish AI Actions, users must have the appropriate permissions assigned within Roles & Permissions.

  • Only admins have publish and unpublish rights by default.

  • Admins can grant publishing permissions to other roles, allowing them to enable AI Actions for use in the entry editor.

  • If a user does not have publishing permissions, they will not be able to activate an AI Action for use across the space.

Manage AI Actions

Admins have the control over AI Actions permissions within their space. The following permissions can be customized per role:

  • Create AI Actions – allows a user to define new AI Actions.

  • Modify AI Actions – enables modifying existing AI Actions, including prompts, variables, and configurations.

  • Invoke AI Actions – grants users the ability to trigger AI Actions within the entry editor.

Best Practices to manage AI Actions 

  • Grant permissions based on need – only provide invoke, create or modify access privileges to roles that require it in certain content workflows.

  • Review permissions regularly – ensure that users have appropriate levels of access as content needs evolve.

  • Test permissions before rollout – use a test space to verify that AI Actions permissions are set correctly before deploying them in production spaces.