Contentful is a headless CMS allowing developers to create, manage, and distribute content across multiple channels and devices with an API-first approach
Contentful is a headless CMS allowing developers to create, manage, and distribute content across multiple channels and devices with an API-first approach On Nagent, Contentful is exposed as a fully-configurable developer tools integration that any agent can call — 106 actions, and OAUTH2, API_KEY authentication. No code is required to wire Contentful into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Contentful to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Contentful into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Contentful, with input parameters and output schema. Drop these into any step of an agent built in Helix.
CONTENTFUL_ACTIVATE_CONTENT_TYPEActivates (publishes) a content type in Contentful. Use this to make a content type available for creating entries. Requires the current version number for optimistic locking.
Input parameters
Current version number of the content type (required for optimistic locking). This is sent via the X-Contentful-Version header.
ID of the space containing the content type
ID of the environment containing the content type (typically 'master')
ID of the content type to activate (publish)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_ARCHIVE_ASSETTool to archive an asset in Contentful. Use when you need to archive an asset to remove it from active use without deleting it permanently.
Input parameters
ID of the asset to archive
ID of the space containing the asset
ID of the environment containing the asset (typically 'master')
Version number of the asset to archive. If not provided, the current version will be fetched automatically.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_ARCHIVE_ENTRYTool to archive an entry in Contentful. Use when you need to move an entry to archived status. The entry must not be currently published, and you may need to provide the X-Contentful-Version header matching the entry's current version.
Input parameters
ID of the entry to archive
ID of the space containing the entry
ID of the environment containing the entry (typically 'master')
Version of the entry to archive. Required for version control. Use the current version number of the entry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_ARCHIVE_RELEASETool to archive a release in Contentful. Use when you need to lock a release to prevent modifications. An archived release cannot be edited until unarchived. Requires the current version number for optimistic locking.
Input parameters
Current version of the release for optimistic locking (X-Contentful-Version header)
The space identifier
The release identifier to archive
The environment identifier (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_APP_DEFINITIONS_KEYSTool to generate an app signing key for a Contentful app definition. Use when you need to create cryptographic keys for app authentication. Either provide generate=true to let Contentful create a key pair (returns private key), or provide a pre-generated public key in JWK format.
Input parameters
JSON Web Key object containing a pre-generated public key to upload. Either this field or generate must be provided.
Set to true to let Contentful generate the key pair. If true, the response will include the private key. Either this field or jwk must be provided.
ID of the organization containing the app definition
ID of the app definition to create a key for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_CONTENT_TYPETool to create a new content type in a Contentful environment. Use when you need to define a new content structure with custom fields. Content types define the schema for entries.
Input parameters
Name of the content type
Array of field definitions for the content type. A content type can have up to 50 fields
ID of the space where the content type will be created
Description of the content type explaining its purpose
ID of the field to use as the display field (entry title) for this content type. Must match the 'id' of one of the fields in the fields array
ID of the environment where the content type will be created (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ENTRY_TASKTool to create a task on a Contentful entry. Use when you need to create workflow tasks for collaboration on entries. Tasks can be assigned to users and are used for managing content review and approval workflows.
Input parameters
Description or body content of the task
Status of the task, typically 'active' for new tasks
ID of the entry to create the task for
ID of the space containing the entry
User to assign the task to, with sys.id, sys.linkType='User', and sys.type='Link'
ID of the environment containing the entry (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ENVIRONMENTTool to create a new environment within a Contentful space. Use when you need to set up a new environment for content management, such as staging or production. Optionally clone from an existing source environment.
Input parameters
Name of the new environment
ID of the space where the environment will be created
ID of the source environment to copy content from. If provided, the new environment will be cloned from this environment. If not provided, an empty environment will be created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ORGANIZATIONS_APP_DEF_ACCESS_GRANTSCreates an access grant for an app definition to allow organizations to install the app. Use when you need to grant installation permissions for an app to specific organizations or all organizations (marketplace apps).
Input parameters
ID of the organization to grant access to, or 'all' to allow all organizations to install the app
Type of grantee. Must be 'Organization'
The ID of the organization that owns the app definition
The ID of the app definition to grant access to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ORGANIZATIONS_APP_DEFINITIONSTool to create a new app definition in a Contentful organization. Use when you need to register a new app that can be installed into space environments.
Input parameters
URL where the root HTML document of the app can be found
Name of the app definition
Locations where the app can be installed and rendered within Contentful
Model for app parameters configuration.
The ID of the organization where the app definition will be created
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ORGANIZATIONS_APP_DEFINITIONS_ACTIONSTool to create an action for a Contentful app definition. Use when you need to define actions that your app can perform, such as endpoint invocations or function calls.
Input parameters
HTTPS URL for the endpoint (required when type is endpoint). Must be a valid HTTPS URL.
Name of the action to create
Type of action - must be one of: endpoint (for HTTP endpoints), function (for Contentful functions), or function-invocation (for function invocations)
Category ID from available categories (e.g., Entries.v1.0, Notification.v1.0). Use get_organizations_app_actions_categories action to retrieve valid category IDs.
ID of the organization containing the app definition
ID of the app definition to create an action for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ORGANIZATIONS_INVITATIONSCreate an invitation to an organization in Contentful (alpha feature). Use this to invite new users to join an organization with a specified role.
Input parameters
Enum for invitation role values.
The email address of the person being invited
The invitee's last name
The invitee's first name
ID of the organization to create the invitation for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ORGANIZATIONS_SECURITY_CONTACTSCreates a security contact for a specific organization. Use when you need to add an email address to receive security notifications for the organization.
Input parameters
Email address for the security contact. This email will receive security-related notifications for the organization.
The ID of the organization to create a security contact for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ORGANIZATIONS_TAXONOMY_CONCEPTSTool to create a new taxonomy concept in a Contentful organization. Use when you need to add a concept for classifying and organizing content within an organization's taxonomy.
Input parameters
Optional globally unique identifier (URI) for the concept
Alternative labels for the concept with locale as key and array of strings as value (e.g., {'en-US': \['Tech', 'IT'\]})
Formal designations like classification codes
The preferred label for the concept with locale as key (e.g., {'en-US': 'Technology'}). At least one locale is required.
Hidden labels for searching with locale as key and array of strings as value (e.g., {'en-US': \['Hidden1'\]})
The organization ID to create the taxonomy concept in
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMESTool to create a new taxonomy concept scheme in an organization. Use when you need to establish a new taxonomy structure or classification system for organizing content.
Input parameters
Optional URI identifier for the concept scheme
Localized preferred label for the concept scheme. Each key is a locale code (e.g., 'en-US') and value is the label text (e.g., {'en-US': 'Product Categories'})
Localized definition/description of the concept scheme. Each key is a locale code (e.g., 'en-US') and value is the definition text (e.g., {'en-US': 'A classification scheme for products'})
The ID of the organization to create the concept scheme in
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_RELEASETool to create a new release in Contentful. Use when you need to group entries and assets into a release for coordinated publishing or tracking. Requires at least one entity to be specified.
Input parameters
Title of the release
Collection of entities (entries/assets) to include in the release
ID of the space where the release will be created
ID of the environment where the release will be created (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_SPACES_API_KEYSTool to create a new Delivery API key for a Contentful space. Use when you need to generate new API credentials for accessing content delivery. The created key provides access to specified environments within the space.
Input parameters
Name for the new API key. This helps identify the key's purpose
ID of the space to create the API key in
Optional description for the API key to explain its purpose or usage
List of environments this API key will have access to. Each environment is specified as a link object with sys.id, sys.type, and sys.linkType
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_SPACES_ENVIRONMENTS_ASSETSTool to create a new asset in a Contentful space environment. Use when you need to upload files like images, videos, or documents. After creation, the asset must be processed before it's available, and you may need to publish it to make it publicly accessible.
Input parameters
Asset fields containing file information and optional title/description with locale-specific values
Model for asset metadata.
ID of the space where the asset will be created
ID of the environment where the asset will be created (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_SPACES_ENVIRONMENTS_ENTRIESTool to create a new entry in a Contentful space environment. Use when you need to add new content entries. Requires specifying the content type ID via X-Contentful-Content-Type header, and providing fields organized by locale.
Input parameters
Entry fields organized by locale. Structure: {fieldName: {locale: value}}. Example: {'title': {'en-US': 'Hello World'}}
Entry metadata including tags. Example: {'tags': \[{'sys': {'id': 'nyCampaign', 'linkType': 'Tag', 'type': 'Link'}}\]}
ID of the space where the entry will be created
ID of the environment where the entry will be created (typically 'master')
Content type ID that defines the structure of the entry being created. Must be a valid content type ID from your space.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_SPACES_ENVIRONMENTS_ENTRIES_COMMENTSTool to create a comment on an entry in Contentful. Use when you need to add a comment to a specific entry. Returns the created comment with status 'active' by default.
Input parameters
The comment text content to create
ID of the entry to comment on
ID of the space containing the entry
ID of the environment containing the entry (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_SPACES_ENVIRONMENTS_EXTENSIONSTool to create a new UI extension within a Contentful space and environment. Use when you need to add custom field editors or sidebar widgets to enhance content editing capabilities.
Input parameters
ID of the space where the extension will be created
Extension configuration object containing name, source, field types, and other settings
ID of the environment where the extension will be created (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_CREATE_SPACES_SCHEDULED_ACTIONSTool to create a scheduled action for publishing or unpublishing entries/assets in Contentful. Use when you need to schedule an automatic publish or unpublish operation at a specific future time.
Input parameters
Type of action to schedule (publish or unpublish)
Reference to the entry or asset to perform the action on
ID of the space where the scheduled action will be created
Reference to the environment where the action will be executed
Timestamp specification for when to execute the action
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_ASSETDeletes an asset by ID from a Contentful environment. Use this when you need to permanently remove an asset. Note: If Contentful rejects deletion for published or archived assets, you must unpublish first using the appropriate CMA endpoints.
Input parameters
ID of the asset to delete
ID of the space containing the asset
ID of the environment containing the asset (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_CONTENT_TYPEDeletes a content type by ID from a Contentful environment. Use this when you need to permanently remove a content type. Note: Content types must be unpublished before deletion if they are published, and must have no associated entries.
Input parameters
ID of the space containing the content type
ID of the environment containing the content type (typically 'master')
ID of the content type to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_ENTRYDeletes an entry by ID from a Contentful environment. Use this when you need to permanently remove an entry. Note: If Contentful rejects deletion for published or archived entries, you must unpublish or unarchive first using the appropriate CMA endpoints.
Input parameters
ID of the entry to delete
ID of the space containing the entry
ID of the environment containing the entry (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_ENVIRONMENTDeletes an environment by ID from a Contentful space. Use this when you need to permanently remove an environment. Note: You cannot delete the 'master' environment or an environment with active aliases.
Input parameters
ID of the space containing the environment
ID of the environment to delete (e.g., 'master' or custom environment ID)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_EXTENSIONDeletes an extension by ID from a Contentful environment. Use this when you need to permanently remove an extension.
Input parameters
ID of the space containing the extension
ID of the extension to delete
ID of the environment containing the extension (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_ORGANIZATIONS_APP_DEF_EVENT_SUBSCRIPTIONDeletes an app event subscription from a Contentful organization. Use this when you need to remove event subscriptions from an app definition.
Input parameters
ID of the organization containing the app definition
ID of the app definition to delete the event subscription from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_ORGANIZATIONS_APP_DEFINITIONS_DETAILSTool to delete app definition details for an organization in Contentful. Use when you need to remove app definition details from an organization.
Input parameters
ID of the organization containing the app definition
ID of the app definition whose details should be deleted
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_ORGANIZATIONS_APP_DEFINITIONS_KEYSTool to delete an app key from an app definition in a Contentful organization. Use when you need to permanently remove an app key.
Input parameters
Key ID (kid) of the app key to delete
ID of the organization containing the app definition
ID of the app definition containing the key
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_ORGANIZATIONS_APP_DEF_SIGNING_SECRETTool to remove the current app signing secret from an app definition. Use when you need to delete an existing signing secret for security or rotation purposes.
Input parameters
ID of the organization containing the app definition
ID of the app definition whose signing secret should be removed
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_ORGANIZATIONS_SECURITY_CONTACTSDeletes a security contact from a Contentful organization. Use this when you need to remove a security contact from an organization.
Input parameters
The ID of the security contact to delete
The ID of the organization
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_RELEASEDeletes a release by ID from a Contentful environment. Use this when you need to permanently remove a release.
Input parameters
ID of the space containing the release
ID of the release to delete
ID of the environment containing the release (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_SCHEDULED_ACTIONCancels a scheduled action by ID in Contentful. Use this when you need to cancel a scheduled publish, unpublish, or other scheduled operation.
Input parameters
ID of the space containing the scheduled action
ID of the environment (typically 'master'). Required to identify which environment the scheduled action belongs to.
ID of the scheduled action to cancel
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_SPACE_MEMBERSHIPDeletes a space membership by ID from a Contentful space. Use this when you need to remove a user's access to a space.
Input parameters
ID of the space containing the membership
ID of the space membership to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_SPACES_API_KEYSTool to delete a single Delivery API key from a Contentful space. Use when you need to permanently remove an API key. This action is useful for revoking access credentials when they are no longer needed or have been compromised.
Input parameters
ID of the space containing the API key
ID of the API key to delete
Version number for optimistic locking. If provided, the API key will only be deleted if this version matches the current version.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_SPACES_UPLOADDeletes an upload by ID from a Contentful space. Use this when you need to permanently remove an upload. Note: This operation uses the upload.contentful.com base URL instead of the standard API URL.
Input parameters
ID of the space containing the upload
ID of the upload to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_DELETE_TAGDeletes a tag by ID from a Contentful environment. Use this when you need to permanently remove a tag.
Input parameters
ID of the tag to delete
ID of the space containing the tag
ID of the environment containing the tag (typically 'master')
Version of the tag to delete (optional, used for optimistic locking)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_APP_BUNDLERetrieves details of a specific app bundle by its ID. Use this to get information about an app bundle including its files, metadata, and associated app definition within a Contentful organization.
Input parameters
ID of the app bundle to retrieve
ID of the organization containing the app definition
ID of the app definition containing the bundle
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_APP_DEFINITIONTool to retrieve details of a specific app definition by its ID. Use when you need information about an app definition in an organization.
Input parameters
The organization ID that owns the app definition
The app definition ID to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ASSETTool to retrieve a single asset from a Contentful environment by its ID. Use when you need to get details about a specific asset including its file information, metadata, and publication status.
Input parameters
ID of the asset to retrieve
ID of the space containing the asset
ID of the environment containing the asset (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_CONTENT_TYPESRetrieves all content types in a Contentful environment. Use this to discover the structure and fields defined for different content types. Content types define the schema for entries and are essential for understanding what data can be stored in the environment.
Input parameters
Number of content types to skip for pagination
Maximum number of content types to return (default: 100, max: 1000)
Order content types by field (e.g. 'sys.createdAt' or '-sys.createdAt' for descending)
ID of the space containing the content types
ID of the environment containing the content types (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_CONTENT_TYPE_SNAPSHOTTool to retrieve a snapshot of a content type by snapshot ID. Use when you need to view the state of a content type at a specific point in time. Snapshots are only available for content types in the master environment.
Input parameters
ID of the space containing the content type
ID of the snapshot to retrieve
ID of the content type to retrieve snapshot for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_CONTENT_TYPE_SNAPSHOTSTool to get all snapshots of a content type in Contentful. Use when you need to retrieve the history of changes made to a content type structure.
Input parameters
Number of snapshots to skip for pagination
Maximum number of snapshots to return (default: 100, max: 1000)
ID of the space containing the content type
ID of the environment (typically 'master')
ID of the content type to retrieve snapshots for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_EDITOR_INTERFACETool to retrieve the editor interface configuration for a content type. Use when you need to see how fields are configured in the Contentful UI. The editor interface is automatically created when a content type is first activated.
Input parameters
ID of the space containing the content type
ID of the environment containing the content type (typically 'master')
ID of the content type to get the editor interface for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ENTRY_COMMENTTool to retrieve a specific comment from an entry in Contentful. Use when you need to get details of a comment including its body, status, author, and metadata.
Input parameters
ID of the entry containing the comment
ID of the space containing the entry
ID of the comment to retrieve
ID of the environment containing the entry (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ENTRY_REFERENCESTool to retrieve references to a specific entry in Contentful. Use when you need to find all entries that reference a particular entry. The include parameter controls how many levels of nested references are returned.
Input parameters
Level of referenced content to include in the response (0-10). Higher values include more nested references.
ID of the entry to get references for
ID of the space containing the entry
ID of the environment containing the entry (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ENTRY_SNAPSHOTSTool to get all snapshots of an entry in Contentful. Use when you need to retrieve the history of changes made to an entry.
Input parameters
Number of snapshots to skip for pagination
Maximum number of snapshots to return (default: 100, max: 1000)
ID of the entry to retrieve snapshots for
ID of the space containing the entry
ID of the environment (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ENVIRONMENTTool to retrieve details of a specific environment by its ID within a space. Use when you need information about a single environment in Contentful.
Input parameters
ID of the space containing the environment
ID of the environment to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONRetrieves details of a specific organization by its ID. Use this when you need to get information about an organization that an admin or owner has access to.
Input parameters
The ID of the organization to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATION_ACCESS_GRANTRetrieves the access grant status for a specific organization. Use this to verify whether the authenticated user has access to a specific organization.
Input parameters
ID of the organization to check access grant for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONSTool to get all organizations an account has access to in Contentful. Use when you need to list available organizations for the authenticated user.
Input parameters
Number of organizations to skip for pagination
Maximum number of organizations to return (default: 100, max: 1000)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_AI_PROVIDERSRetrieves all AI providers configured for an organization in Contentful. Use this to list AI service providers (OpenAI, AWS Bedrock, Google Gemini, etc.) that have been configured for the organization.
Input parameters
ID of the organization to get AI providers for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_ACTIONS_CATEGORIESRetrieves app action categories for a Contentful organization. Use this to discover available app action categories and their parameters.
Input parameters
The ID of the organization
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEF_EVENT_SUBSCRIPTIONTool to retrieve details of an app event subscription by organization and app definition ID. Use when you need to check the configuration of event subscriptions for an app.
Input parameters
ID of the organization containing the app definition
ID of the app definition to retrieve the event subscription from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONSRetrieves all app definitions for a specific organization. Use when you need to list or discover apps owned by an organization.
Input parameters
ID of the organization to retrieve app definitions for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_ACCESS_GRANTSGet all app access grants for a specific app definition within an organization. Use when you need to list which organizations can install a specific app definition.
Input parameters
Number of access grants to skip for pagination
Maximum number of access grants to return (default: 100, max: 1000)
The ID of the organization
The ID of the app definition
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_ACTIONSTool to get all actions of an app definition within an organization. Use when you need to retrieve the list of actions defined for a specific Contentful app.
Input parameters
The ID of the organization
The ID of the app definition
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_ACTIONS2Tool to read a specific app action from an app definition within an organization. Use when you need to retrieve details of a particular action defined for a Contentful app.
Input parameters
The ID of the specific app action to retrieve
The ID of the organization that contains the app definition
The ID of the app definition that contains the action
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_APP_BUNDLESTool to get all app bundles for a specific app definition within an organization. Use when you need to list all uploaded bundles for a Contentful app.
Input parameters
ID of the organization containing the app definition
ID of the app definition to retrieve bundles for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_FUNCTIONSTool to get all functions of an app definition within an organization. Use when you need to retrieve the list of functions defined for a specific Contentful app.
Input parameters
The ID of the organization
The ID of the app definition
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_KEYSTool to retrieve all app keys for a specific app definition in a Contentful organization. Use when you need to list cryptographic keys for app authentication.
Input parameters
ID of the organization containing the app definition
ID of the app definition to retrieve keys for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_SIGNING_SECRETTool to retrieve the current app signing secret for an app definition. Use when you need to verify the existence or view the last 4 characters of a signing secret. Note: Full secret is only available at creation time.
Input parameters
ID of the organization containing the app definition
ID of the app definition whose signing secret should be retrieved
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_ENABLEMENTSRetrieves feature enablements for a specific organization in Contentful. Use this to check which AI and vectorization features are enabled for the organization.
Input parameters
The ID of the organization to retrieve enablements for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_INVITATIONSRetrieves a single invitation for an organization (alpha). Use this to get details about a specific invitation including invitee information and status. Note: This endpoint is in alpha state and may be subject to breaking changes.
Input parameters
The ID of the invitation to retrieve
The ID of the organization
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_ORGANIZATION_PERIODIC_USAGESTool to get organization periodic usage statistics. Use when you need to retrieve API usage metrics for an organization during a specific time period, with optional filtering by metric type and date range.
Input parameters
Order results by usage
Filter by specific metrics (comma-separated values like 'cma,cpa,gql')
The ID of the organization
End date for the date range filter (ISO 8601 format: YYYY-MM-DD)
Start date for the date range filter (ISO 8601 format: YYYY-MM-DD)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_ROLESRetrieves all space roles in an organization. Use this to list roles that define user permissions and access levels within an organization's spaces.
Input parameters
The ID of the organization to retrieve roles from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_SECURITY_CONTACTSRetrieves security contacts for a specific organization that an admin or owner has access to. Use this to get the list of security contacts configured for an organization.
Input parameters
The ID of the organization to retrieve security contacts for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_SPACE_ENABLEMENTSRetrieves all space enablements for a specific organization. Use when you need to check which features are enabled for spaces within an organization.
Input parameters
The ID of the organization to retrieve space enablements for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_SPACE_PERIODIC_USAGESTool to retrieve space periodic usage data for an organization. Use this when you need to analyze usage metrics, monitor API consumption, or track resource utilization over time.
Input parameters
Order results by usage. Example: 'usage' or '-usage'
Comma-separated list of metrics to filter by (e.g., 'cma,cpa,gql')
End date for the usage period in ISO 8601 format (e.g., '2020-01-05')
The ID of the organization to retrieve space periodic usages for
Start date for the usage period in ISO 8601 format (e.g., '2020-01-01')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPTSRetrieves all taxonomy concepts for an organization in Contentful. Use this to list concepts that can be used to classify and organize content within the organization.
Input parameters
Number of concepts to skip for pagination
Maximum number of concepts to return (default: 100, max: 1000)
The organization ID to retrieve taxonomy concepts from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPTS_ANCESTORSRetrieves the list of ancestor concepts for a specific taxonomy concept. Use this when you need to understand the hierarchical lineage of a concept in the taxonomy structure.
Input parameters
The ID of the taxonomy concept to retrieve ancestors for
The ID of the organization
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMESTool to retrieve all taxonomy concept schemes from an organization. Use when you need to list or discover the taxonomy structure and concept schemes available in an organization.
Input parameters
Number of concept schemes to skip for pagination
Maximum number of concept schemes to return (default: 100, max: 1000)
The ID of the organization to retrieve concept schemes from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMES2Tool to retrieve a specific taxonomy concept scheme from an organization. Use when you need to get detailed information about a taxonomy concept scheme including its concepts, labels, and definitions.
Input parameters
The ID of the organization that contains the concept scheme
The ID of the taxonomy concept scheme to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMES_TOTALRetrieves the total count of taxonomy concept schemes for a specific organization. Use this when you need to get the number of concept schemes configured for an organization's taxonomy.
Input parameters
The ID of the organization to retrieve taxonomy concept schemes total for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPTS_TOTALRetrieves the total count of taxonomy concepts for a specific organization. Use this when you need to get the number of concepts configured for an organization's taxonomy.
Input parameters
The ID of the organization to retrieve taxonomy concepts total for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_RELEASETool to get a single release by ID from Contentful. Use when you need to retrieve details about a specific release including its entities, metadata, and archive status.
Input parameters
ID of the space containing the release
ID of the release to retrieve
ID of the environment containing the release (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_SPACERetrieves metadata of a specific space by its ID. Returns space-level details only (name, locales, sys fields) — not entries, content types, or assets. The returned sys.version is required for subsequent CONTENTFUL_UPDATE_SPACE calls to avoid version conflict errors.
Input parameters
ID of the space to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_SPACE_MEMBERSHIPSTool to get all space memberships in a Contentful space. Use when you need to list all users who have access to a space and their assigned roles. Returns paginated results with membership details including admin status and role assignments.
Input parameters
Number of memberships to skip for pagination
Maximum number of memberships to return (default: 25, max: 1000)
ID of the space to retrieve memberships from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_SPACES_API_KEYSTool to retrieve all Delivery API keys for a specific Contentful space. Use when you need to list all API keys configured for content delivery. This action returns key details including name, access token, policies, and associated environments.
Input parameters
Number of API keys to skip for pagination
Maximum number of API keys to return (default: 100, max: 1000)
ID of the space to retrieve API keys from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_SPACES_ENVIRONMENTSRetrieves all environments of a space in Contentful. Use this to list all environments (including the master environment) within a specific space.
Input parameters
ID of the space to get environments from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_SPACES_ENVIRONMENTS_APP_INSTALLATIONSLists all app installations in a specific Contentful environment. Use this to discover which apps are currently installed in an environment.
Input parameters
ID of the space to retrieve app installations from
ID of the environment to retrieve app installations from (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_SPACES_ENVIRONMENTS_ASSETSRetrieves all assets from a specific environment in a Contentful space. Use this to list and browse assets like images, videos, and documents. Supports pagination and ordering for large asset collections.
Input parameters
Number of assets to skip for pagination
Maximum number of assets to return (default: 100, max: 1000)
Order assets by field (e.g. 'sys.createdAt' or '-sys.createdAt' for descending)
ID of the space containing the assets
ID of the environment containing the assets (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_SPACES_ENVIRONMENTS_LOCALESTool to retrieve all locales of a space environment in Contentful. Use when you need to list all available locales including their codes, names, default status, and fallback configurations.
Input parameters
ID of the space to get locales from
ID of the environment to get locales from (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_SPACES_ENVS_APP_INSTALLATIONS_FUNCTIONSTool to get all functions for an app installation in a Contentful environment. Use when you need to retrieve the list of functions defined for an installed app in a specific space and environment.
Input parameters
The ID of the Contentful space
The ID of the environment (e.g., 'master')
The ID of the installed app
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_GET_USERS_METool to retrieve information about the currently authenticated user. Use when you need to get details about the user making the API calls, such as their profile information, email, or account status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_LIST_ENTRIESTool to retrieve all entries from a Contentful space environment. Use when you need to list, search, or filter content entries. Supports pagination, sorting, field selection, and filtering by content type or custom fields.
Input parameters
Number of entries to skip for pagination
Maximum number of entries to return per page (default: 100, max: 1000)
Sort results by a specified field (e.g., 'sys.createdAt' or '-fields.name' for reverse order)
Full-text search query to filter entries
Retrieve content in specified language/region code
Comma-separated list of specific fields to return (e.g., 'sys.id,fields.title'). Supports depth of 2 levels maximum.
Number of levels to resolve linked entries and assets (0-10, default: 1)
ID of the space containing the entries
Filter entries by content type ID. Required when filtering by custom fields.
ID of the environment containing the entries (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_LIST_SPACESLists all spaces that the authenticated user has access to in Contentful. This is a fundamental operation needed before performing any other content management actions since most operations require a space ID. To paginate, increment `skip` by `limit` across successive calls; stop when the returned count is less than `limit`.
Input parameters
Number of spaces to skip for pagination
Maximum number of spaces to return (default: 100, max: 1000)
Order spaces by field (e.g. 'sys.createdAt' or '-sys.createdAt')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_LIST_SPACES_ROLESTool to retrieve all roles from a Contentful space. Use this to list roles that define user permissions and access levels within a space.
Input parameters
ID of the space to retrieve roles from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_PUBLISH_ENTRYTool to publish an entry in Contentful, making it available via the Content Delivery API. Use when you need to make an entry publicly accessible or move it from draft to published status. The entry must not be archived and should have all required fields completed. Publishing increments the entry version.
Input parameters
ID of the entry to publish
ID of the space containing the entry
ID of the environment containing the entry (typically 'master')
Version of the entry to publish. Required for version control. Use the current version number of the entry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_QUERY_ASSET_COLLECTIONTool to retrieve multiple assets with pagination and filtering via GraphQL API. Use when you need to query assets from Contentful with advanced filtering, sorting, and locale selection. Supports preview mode and fallback locale options.
Input parameters
Zero-indexed offset in the collection from which items are fetched. Default is 0
Maximum number of items to fetch. Default is 100, maximum is 1000
Order specifications to apply on the collection query. Example: \['sys_firstPublishedAt_ASC', 'sys_id_DESC'\]
Filter specifications to apply on the collection query (AssetFilter type). Example: {'contentType': 'image/jpeg'}
Locale for the collection items. If not set, the default locale is used. Example: 'en-US'
When set to true, returns non-published content. Default is false
ID of the space to query assets from
Content Delivery API (CDA) access token. If not provided, will attempt to use token from metadata. Required for GraphQL Content API access. You can obtain this from the space's API keys.
When set to false, fields without a value in the requested locale return null instead of the fallback locale. Default is true
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_QUERY_GRAPHQL_CONTENT_TYPE_COLLECTIONTool to query a collection of entries for a specific content type using GraphQL. Use when you need to fetch multiple entries with filtering, sorting, pagination, or preview mode. The query field name must be the camelCase content type ID with 'Collection' suffix (e.g., 'blogPostCollection').
Input parameters
GraphQL query string. Must be in the format: { contentTypeIdCollection { items { sys { id } fieldName } } }. The content type ID should be in camelCase with 'Collection' suffix. Example: '{ testArticleCollection { items { sys { id publishedAt } title } } }'
ID of the Contentful space
Optional GraphQL variables for parameterized queries. Used to pass dynamic values to the query (e.g., filters, pagination parameters). Example: {'limit': 10, 'preview': true}
Content Delivery API (CDA) access token. If not provided, will attempt to use token from metadata. Required for GraphQL Content API access.
ID of the environment (optional, omit for default environment). Use 'master' for production environment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_APP_DEFINITIONTool to update an app definition by ID in a Contentful organization. Use when you need to modify an app's name, source URL, locations, or parameters.
Input parameters
The source URL where the root HTML document of the app is hosted
The name of the app
Array of location objects specifying where the app will be rendered in the Contentful web app
Model for app parameters.
The organization ID that owns the app definition
The app definition ID to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_EDITOR_INTERFACETool to update the editor interface configuration for a content type. Use when you need to customize how fields are displayed and edited in the Contentful UI. The version number is required to prevent conflicts when multiple users update the same editor interface.
Input parameters
Current version of the editor interface used for optimistic locking. Get this from the sys.version field when fetching the editor interface. Sent via the X-Contentful-Version header.
Array of control objects defining how each field should be displayed and edited in the Contentful UI
ID of the space containing the content type
ID of the environment containing the content type (typically 'master')
ID of the content type to update the editor interface for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ENTRYTool to create or update an entry in a Contentful space environment. Use when you need to modify entry content or create a new entry with a specific ID. Requires the content type ID, entry version for updates, and field values organized by locale.
Input parameters
Entry field values organized by field name and locale. Structure: {field_name: {locale: value}}. Example: {'title': {'en-US': 'My Title'}, 'body': {'en-US': 'Content'}}. Available fields and their types depend on the content_type definition.
Current entry version for optimistic locking. Provide the latest value from sys.version. This is sent via the X-Contentful-Version header to prevent conflicting updates.
ID of the entry to create or update
Entry metadata including tags. Example: {'tags': \[\]} or {'tags': \[{'sys': {'type': 'Link', 'linkType': 'Tag', 'id': 'tagId'}}\]}
ID of the space containing the entry
Content type ID for this entry (e.g., 'testArticle', 'blogPost'). Must match an existing content type in the space.
ID of the environment containing the entry (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ORGANIZATIONS_APP_DEF_EVENT_SUBSCRIPTIONTool to update or create an app event subscription in a Contentful organization. Use when you need to configure event subscriptions for an app definition to receive webhooks.
Input parameters
List of event topics to subscribe to (e.g., 'Entry.create', 'Entry.update', 'Asset.create'). Events matching these topics will be sent to the targetUrl.
Subscription URL that will receive events. Must be a valid HTTPS URL.
ID of the organization containing the app definition
ID of the app definition to update the event subscription for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ORGANIZATIONS_APP_DEFINITIONS_ACTIONSTool to update an action for a Contentful app definition. Use when you need to modify existing action properties such as name, URL, type, or category.
Input parameters
HTTPS URL for the endpoint (required when type is endpoint). Must be a valid HTTPS URL.
Updated name of the action
Type of action - must be one of: endpoint (for HTTP endpoints), function (for Contentful functions), or function-invocation (for function invocations)
Category ID from available categories (e.g., Entries.v1.0, Notification.v1.0). Use get_organizations_app_actions_categories action to retrieve valid category IDs.
ID of the app action to update
ID of the organization containing the app definition
ID of the app definition containing the action
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ORGANIZATIONS_APP_DEFINITIONS_DETAILSTool to create or update app definition details for an organization in Contentful. Use when you need to initialize or modify app details such as icons or preview images. Note: This endpoint accepts an empty body to initialize details; properties like 'name' and 'src' are not accepted here and will cause validation errors.
Input parameters
ID of the organization containing the app definition
ID of the app definition whose details should be updated
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ORGANIZATIONS_APP_DEF_SIGNING_SECRETTool to create or overwrite the app signing secret for an app definition. Use when you need to set up webhook signature verification or rotate an existing secret. Note: This operation overwrites any existing signing secret.
Input parameters
The signing secret value. Must be a 64-character hexadecimal string used to verify webhook signatures from Contentful.
ID of the organization containing the app definition
ID of the app definition for which to create or update the signing secret
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ORGANIZATIONS_ENABLEMENTSUpdates feature enablements for a specific organization in Contentful. Use this to enable or disable AI and vectorization features for the organization. Requires the current version number for optimistic locking to prevent conflicts.
Input parameters
Current version of the enablements document for optimistic locking. Provide the latest value from sys.version; it is sent via the X-Contentful-Version header.
Vectorization configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API.
Custom AI actions configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API.
The ID of the organization to update enablements for
Built-in AI actions configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ORGANIZATIONS_SECURITY_CONTACTSUpdates an organization security contact that an admin or owner has access to. Use this to change the email address of a security contact.
Input parameters
The updated email address for the security contact
The ID of the security contact to update
The ID of the organization
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ORGANIZATIONS_TAXONOMY_CONCEPTSTool to create or update a taxonomy concept with a user-defined ID in a Contentful organization. Use when you need to create a concept with a specific ID or update an existing concept's properties.
Input parameters
Optional globally unique identifier (URI) for the concept
Version number for updates (used for optimistic locking). Required when updating an existing concept, not needed when creating a new concept with a user-defined ID. Sent via X-Contentful-Version header.
Alternative labels for the concept with locale as key and array of strings as value (e.g., {'en-US': \['Tech', 'IT'\]})
Formal designations like classification codes
The preferred label for the concept with locale as key (e.g., {'en-US': 'Technology'}). At least one locale is required.
User-defined ID for the taxonomy concept to create or update
Hidden labels for searching with locale as key and array of strings as value (e.g., {'en-US': \['Hidden1'\]})
The organization ID containing the taxonomy concept
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMESTool to create or update a taxonomy concept scheme with a user-defined ID in an organization. Use when you need to create a new classification scheme or update an existing one with localized labels and definitions.
Input parameters
Optional URI identifier for the concept scheme
Version number for updates (used for optimistic locking). Required when updating an existing concept scheme, not needed for creation. Sent via X-Contentful-Version header.
Localized preferred label for the concept scheme. Keys are locale codes (e.g., 'en-US'), values are the labels in that locale.
Localized definition for the concept scheme. Keys are locale codes (e.g., 'en-US'), values are the definitions in that locale.
The ID of the organization to create/update the concept scheme in
User-defined ID for the concept scheme. This will be used as the unique identifier for the concept scheme.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_SPACEUpdates the name of a specific space. Notes: - The version number is required to ensure you're updating the latest version of the space. - You can get the current version from the sys.version field when fetching space details. - Only the name of the space can be updated.
Input parameters
New name for the space
Current space version used for optimistic locking. Provide the latest value from sys.version; it is sent via the X-Contentful-Version header. Must match the current sys.version exactly (retrieve via CONTENTFUL_GET_SPACE); an outdated value causes a version conflict error.
ID of the space to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_UPDATE_SPACES_ENVIRONMENTS_TAGSCreates or updates a tag in a Contentful environment. Use this when you need to modify an existing tag's name or create a new one.
Input parameters
System metadata for the tag (must include id and type fields)
Display name for the tag
ID of the tag to update
ID of the space containing the tag
ID of the environment containing the tag (typically 'master')
Version of the tag to update (used for optimistic locking). If not provided, the API will use version 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONTENTFUL_VALIDATE_BULK_ACTIONTool to validate a bulk action before executing it. Use when you need to check if multiple entries or assets can be published in bulk without actually publishing them. This helps identify potential issues before attempting the actual bulk operation.
Input parameters
Enum for bulk action types.
Collection of entities (entries or assets) to validate for bulk action
ID of the space containing the entries/assets to validate
ID of the environment containing the entries/assets to validate (typically 'master')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 44 agents privately built on Nagent that already use Contentful.
Build on Nagent
Connect Contentful to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Contentful, and click "Connect Now." You'll authenticate with OAUTH2, API_KEY — Nagent handles credential storage and refresh automatically. Once connected, Contentful is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Contentful is connected, you configure its 106 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Contentful steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Contentful event fires, the agent kicks off automatically.
Every Contentful action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Contentful ships with 106 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Contentful together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Contentful-based workflows tailored to your business.