# Contentful Contentful is a headless CMS allowing developers to create, manage, and distribute content across multiple channels and devices with an API-first approach - **Category:** developer tools - **Auth:** OAUTH2, API_KEY - **Composio Managed App Available?** Yes - **Tools:** 105 - **Triggers:** 0 - **Slug:** `CONTENTFUL` - **Version:** 20260316_00 ## Tools ### Activate Content Type **Slug:** `CONTENTFUL_ACTIVATE_CONTENT_TYPE` Activates (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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `version` | integer | Yes | Current version number of the content type (required for optimistic locking). This is sent via the X-Contentful-Version header. | | `space_id` | string | Yes | ID of the space containing the content type | | `environment_id` | string | Yes | ID of the environment containing the content type (typically 'master') | | `content_type_id` | string | Yes | ID of the content type to activate (publish) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Archive Asset **Slug:** `CONTENTFUL_ARCHIVE_ASSET` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `asset_id` | string | Yes | ID of the asset to archive | | `space_id` | string | Yes | ID of the space containing the asset | | `environment_id` | string | Yes | ID of the environment containing the asset (typically 'master') | | `X_Contentful_Version` | integer | No | Version number of the asset to archive. If not provided, the current version will be fetched automatically. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Archive Entry **Slug:** `CONTENTFUL_ARCHIVE_ENTRY` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `entry_id` | string | Yes | ID of the entry to archive | | `space_id` | string | Yes | ID of the space containing the entry | | `environment_id` | string | Yes | ID of the environment containing the entry (typically 'master') | | `X-Contentful-Version` | integer | No | Version of the entry to archive. Required for version control. Use the current version number of the entry. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Archive Release **Slug:** `CONTENTFUL_ARCHIVE_RELEASE` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `version` | integer | Yes | Current version of the release for optimistic locking (X-Contentful-Version header) | | `space_id` | string | Yes | The space identifier | | `release_id` | string | Yes | The release identifier to archive | | `environment_id` | string | Yes | The environment identifier (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create App Signing Key **Slug:** `CONTENTFUL_CREATE_APP_DEFINITIONS_KEYS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `jwk` | object | No | JSON Web Key object containing a pre-generated public key to upload. Either this field or generate must be provided. | | `generate` | boolean | No | 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. | | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition to create a key for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Content Type **Slug:** `CONTENTFUL_CREATE_CONTENT_TYPE` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Name of the content type | | `fields` | array | Yes | Array of field definitions for the content type. A content type can have up to 50 fields | | `space_id` | string | Yes | ID of the space where the content type will be created | | `description` | string | No | Description of the content type explaining its purpose | | `displayField` | string | No | 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 | | `environment_id` | string | Yes | ID of the environment where the content type will be created (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Entry Task **Slug:** `CONTENTFUL_CREATE_ENTRY_TASK` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body` | string | Yes | Description or body content of the task | | `status` | string | Yes | Status of the task, typically 'active' for new tasks | | `entry_id` | string | Yes | ID of the entry to create the task for | | `space_id` | string | Yes | ID of the space containing the entry | | `assignedTo` | object | Yes | User to assign the task to, with sys.id, sys.linkType='User', and sys.type='Link' | | `environment_id` | string | Yes | ID of the environment containing the entry (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Environment **Slug:** `CONTENTFUL_CREATE_ENVIRONMENT` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Name of the new environment | | `space_id` | string | Yes | ID of the space where the environment will be created | | `source_environment_id` | string | No | 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create App Access Grant **Slug:** `CONTENTFUL_CREATE_ORGANIZATIONS_APP_DEF_ACCESS_GRANTS` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `grantee_id` | string | Yes | ID of the organization to grant access to, or 'all' to allow all organizations to install the app | | `grantee_type` | string ("Organization") | Yes | Type of grantee. Must be 'Organization' | | `organization_id` | string | Yes | The ID of the organization that owns the app definition | | `app_definition_id` | string | Yes | The ID of the app definition to grant access to | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Organizations App Definitions **Slug:** `CONTENTFUL_CREATE_ORGANIZATIONS_APP_DEFINITIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `src` | string | No | URL where the root HTML document of the app can be found | | `name` | string | Yes | Name of the app definition | | `locations` | array | No | Locations where the app can be installed and rendered within Contentful | | `parameters` | object | No | Model for app parameters configuration. | | `organization_id` | string | Yes | The ID of the organization where the app definition will be created | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create App Definition Action **Slug:** `CONTENTFUL_CREATE_ORGANIZATIONS_APP_DEFINITIONS_ACTIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | No | HTTPS URL for the endpoint (required when type is endpoint). Must be a valid HTTPS URL. | | `name` | string | Yes | Name of the action to create | | `type` | string ("endpoint" | "function" | "function-invocation") | Yes | Type of action - must be one of: endpoint (for HTTP endpoints), function (for Contentful functions), or function-invocation (for function invocations) | | `category` | string | Yes | 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. | | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition to create an action for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Organization Invitation **Slug:** `CONTENTFUL_CREATE_ORGANIZATIONS_INVITATIONS` Create 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `role` | string ("member" | "developer" | "admin" | "owner") | No | Enum for invitation role values. | | `email` | string | Yes | The email address of the person being invited | | `lastName` | string | No | The invitee's last name | | `firstName` | string | No | The invitee's first name | | `organization_id` | string | Yes | ID of the organization to create the invitation for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Organizations Security Contacts **Slug:** `CONTENTFUL_CREATE_ORGANIZATIONS_SECURITY_CONTACTS` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `email` | string | Yes | Email address for the security contact. This email will receive security-related notifications for the organization. | | `organization_id` | string | Yes | The ID of the organization to create a security contact for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Organizations Taxonomy Concepts **Slug:** `CONTENTFUL_CREATE_ORGANIZATIONS_TAXONOMY_CONCEPTS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `uri` | string | No | Optional globally unique identifier (URI) for the concept | | `altLabels` | object | No | Alternative labels for the concept with locale as key and array of strings as value (e.g., {'en-US': ['Tech', 'IT']}) | | `notations` | array | No | Formal designations like classification codes | | `prefLabel` | object | Yes | The preferred label for the concept with locale as key (e.g., {'en-US': 'Technology'}). At least one locale is required. | | `hiddenLabels` | object | No | Hidden labels for searching with locale as key and array of strings as value (e.g., {'en-US': ['Hidden1']}) | | `organization_id` | string | Yes | The organization ID to create the taxonomy concept in | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Organizations Taxonomy Concept Schemes **Slug:** `CONTENTFUL_CREATE_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `uri` | string | No | Optional URI identifier for the concept scheme | | `prefLabel` | object | Yes | 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'}) | | `definition` | object | No | 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'}) | | `organization_id` | string | Yes | The ID of the organization to create the concept scheme in | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Release **Slug:** `CONTENTFUL_CREATE_RELEASE` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `title` | string | Yes | Title of the release | | `entities` | object | Yes | Collection of entities (entries/assets) to include in the release | | `space_id` | string | Yes | ID of the space where the release will be created | | `environment_id` | string | Yes | ID of the environment where the release will be created (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Delivery API Key **Slug:** `CONTENTFUL_CREATE_SPACES_API_KEYS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | Name for the new API key. This helps identify the key's purpose | | `space_id` | string | Yes | ID of the space to create the API key in | | `description` | string | No | Optional description for the API key to explain its purpose or usage | | `environments` | array | Yes | 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Asset **Slug:** `CONTENTFUL_CREATE_SPACES_ENVIRONMENTS_ASSETS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | object | Yes | Asset fields containing file information and optional title/description with locale-specific values | | `metadata` | object | No | Model for asset metadata. | | `space_id` | string | Yes | ID of the space where the asset will be created | | `environment_id` | string | Yes | ID of the environment where the asset will be created (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Entry **Slug:** `CONTENTFUL_CREATE_SPACES_ENVIRONMENTS_ENTRIES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | object | Yes | Entry fields organized by locale. Structure: {fieldName: {locale: value}}. Example: {'title': {'en-US': 'Hello World'}} | | `metadata` | object | No | Entry metadata including tags. Example: {'tags': [{'sys': {'id': 'nyCampaign', 'linkType': 'Tag', 'type': 'Link'}}]} | | `space_id` | string | Yes | ID of the space where the entry will be created | | `environment_id` | string | Yes | ID of the environment where the entry will be created (typically 'master') | | `X-Contentful-Content-Type` | string | Yes | Content type ID that defines the structure of the entry being created. Must be a valid content type ID from your space. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Entry Comment **Slug:** `CONTENTFUL_CREATE_SPACES_ENVIRONMENTS_ENTRIES_COMMENTS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body` | string | Yes | The comment text content to create | | `entry_id` | string | Yes | ID of the entry to comment on | | `space_id` | string | Yes | ID of the space containing the entry | | `environment_id` | string | Yes | ID of the environment containing the entry (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Extension **Slug:** `CONTENTFUL_CREATE_SPACES_ENVIRONMENTS_EXTENSIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space where the extension will be created | | `extension` | object | Yes | Extension configuration object containing name, source, field types, and other settings | | `environment_id` | string | Yes | ID of the environment where the extension will be created (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Scheduled Action **Slug:** `CONTENTFUL_CREATE_SPACES_SCHEDULED_ACTIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `action` | string ("publish" | "unpublish") | Yes | Type of action to schedule (publish or unpublish) | | `entity` | object | Yes | Reference to the entry or asset to perform the action on | | `space_id` | string | Yes | ID of the space where the scheduled action will be created | | `environment` | object | Yes | Reference to the environment where the action will be executed | | `scheduledFor` | object | Yes | Timestamp specification for when to execute the action | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Asset **Slug:** `CONTENTFUL_DELETE_ASSET` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `asset_id` | string | Yes | ID of the asset to delete | | `space_id` | string | Yes | ID of the space containing the asset | | `environment_id` | string | Yes | ID of the environment containing the asset (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Content Type **Slug:** `CONTENTFUL_DELETE_CONTENT_TYPE` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the content type | | `environment_id` | string | Yes | ID of the environment containing the content type (typically 'master') | | `content_type_id` | string | Yes | ID of the content type to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Entry **Slug:** `CONTENTFUL_DELETE_ENTRY` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `entry_id` | string | Yes | ID of the entry to delete | | `space_id` | string | Yes | ID of the space containing the entry | | `environment_id` | string | Yes | ID of the environment containing the entry (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Environment **Slug:** `CONTENTFUL_DELETE_ENVIRONMENT` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the environment | | `environment_id` | string | Yes | ID of the environment to delete (e.g., 'master' or custom environment ID) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Extension **Slug:** `CONTENTFUL_DELETE_EXTENSION` Deletes an extension by ID from a Contentful environment. Use this when you need to permanently remove an extension. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the extension | | `extension_id` | string | Yes | ID of the extension to delete | | `environment_id` | string | Yes | ID of the environment containing the extension (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete App Event Subscription **Slug:** `CONTENTFUL_DELETE_ORGANIZATIONS_APP_DEF_EVENT_SUBSCRIPTION` Deletes an app event subscription from a Contentful organization. Use this when you need to remove event subscriptions from an app definition. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition to delete the event subscription from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete App Definition Details **Slug:** `CONTENTFUL_DELETE_ORGANIZATIONS_APP_DEFINITIONS_DETAILS` Tool to delete app definition details for an organization in Contentful. Use when you need to remove app definition details from an organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition whose details should be deleted | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete App Key **Slug:** `CONTENTFUL_DELETE_ORGANIZATIONS_APP_DEFINITIONS_KEYS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `key_kid` | string | Yes | Key ID (kid) of the app key to delete | | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition containing the key | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete App Definition Signing Secret **Slug:** `CONTENTFUL_DELETE_ORGANIZATIONS_APP_DEF_SIGNING_SECRET` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition whose signing secret should be removed | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Organization Security Contact **Slug:** `CONTENTFUL_DELETE_ORGANIZATIONS_SECURITY_CONTACTS` Deletes a security contact from a Contentful organization. Use this when you need to remove a security contact from an organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `contact_id` | string | Yes | The ID of the security contact to delete | | `organization_id` | string | Yes | The ID of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Release **Slug:** `CONTENTFUL_DELETE_RELEASE` Deletes a release by ID from a Contentful environment. Use this when you need to permanently remove a release. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the release | | `releases_id` | string | Yes | ID of the release to delete | | `environment_id` | string | Yes | ID of the environment containing the release (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Scheduled Action **Slug:** `CONTENTFUL_DELETE_SCHEDULED_ACTION` Cancels a scheduled action by ID in Contentful. Use this when you need to cancel a scheduled publish, unpublish, or other scheduled operation. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the scheduled action | | `environment_sys_id` | string | Yes | ID of the environment (typically 'master'). Required to identify which environment the scheduled action belongs to. | | `scheduled_action_id` | string | Yes | ID of the scheduled action to cancel | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Space Membership **Slug:** `CONTENTFUL_DELETE_SPACE_MEMBERSHIP` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the membership | | `space_membership_id` | string | Yes | ID of the space membership to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Delivery API Key **Slug:** `CONTENTFUL_DELETE_SPACES_API_KEYS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the API key | | `api_key_id` | string | Yes | ID of the API key to delete | | `x_contentful_version` | integer | No | Version number for optimistic locking. If provided, the API key will only be deleted if this version matches the current version. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Spaces Upload **Slug:** `CONTENTFUL_DELETE_SPACES_UPLOAD` Deletes 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the upload | | `upload_id` | string | Yes | ID of the upload to delete | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Tag **Slug:** `CONTENTFUL_DELETE_TAG` Deletes a tag by ID from a Contentful environment. Use this when you need to permanently remove a tag. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `tag_id` | string | Yes | ID of the tag to delete | | `space_id` | string | Yes | ID of the space containing the tag | | `environment_id` | string | Yes | ID of the environment containing the tag (typically 'master') | | `x_contentful_version` | integer | No | Version of the tag to delete (optional, used for optimistic locking) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Bundle **Slug:** `CONTENTFUL_GET_APP_BUNDLE` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `bundle_id` | string | Yes | ID of the app bundle to retrieve | | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition containing the bundle | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Definition **Slug:** `CONTENTFUL_GET_APP_DEFINITION` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The organization ID that owns the app definition | | `app_definition_id` | string | Yes | The app definition ID to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Asset **Slug:** `CONTENTFUL_GET_ASSET` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `asset_id` | string | Yes | ID of the asset to retrieve | | `space_id` | string | Yes | ID of the space containing the asset | | `environment_id` | string | Yes | ID of the environment containing the asset (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Content Types **Slug:** `CONTENTFUL_GET_CONTENT_TYPES` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of content types to skip for pagination | | `limit` | integer | No | Maximum number of content types to return (default: 100, max: 1000) | | `order` | string | No | Order content types by field (e.g. 'sys.createdAt' or '-sys.createdAt' for descending) | | `space_id` | string | Yes | ID of the space containing the content types | | `environment_id` | string | Yes | ID of the environment containing the content types (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Content Type Snapshot **Slug:** `CONTENTFUL_GET_CONTENT_TYPE_SNAPSHOT` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the content type | | `snapshot_id` | string | Yes | ID of the snapshot to retrieve | | `content_type_id` | string | Yes | ID of the content type to retrieve snapshot for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Content Type Snapshots **Slug:** `CONTENTFUL_GET_CONTENT_TYPE_SNAPSHOTS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of snapshots to skip for pagination | | `limit` | integer | No | Maximum number of snapshots to return (default: 100, max: 1000) | | `space_id` | string | Yes | ID of the space containing the content type | | `environment_id` | string | Yes | ID of the environment (typically 'master') | | `content_type_id` | string | Yes | ID of the content type to retrieve snapshots for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Editor Interface **Slug:** `CONTENTFUL_GET_EDITOR_INTERFACE` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the content type | | `environment_id` | string | Yes | ID of the environment containing the content type (typically 'master') | | `content_type_id` | string | Yes | ID of the content type to get the editor interface for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Entry Comment **Slug:** `CONTENTFUL_GET_ENTRY_COMMENT` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `entry_id` | string | Yes | ID of the entry containing the comment | | `space_id` | string | Yes | ID of the space containing the entry | | `comment_id` | string | Yes | ID of the comment to retrieve | | `environment_id` | string | Yes | ID of the environment containing the entry (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Entry References **Slug:** `CONTENTFUL_GET_ENTRY_REFERENCES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `include` | integer | Yes | Level of referenced content to include in the response (0-10). Higher values include more nested references. | | `entry_id` | string | Yes | ID of the entry to get references for | | `space_id` | string | Yes | ID of the space containing the entry | | `environment_id` | string | Yes | ID of the environment containing the entry (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Entry Snapshots **Slug:** `CONTENTFUL_GET_ENTRY_SNAPSHOTS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of snapshots to skip for pagination | | `limit` | integer | No | Maximum number of snapshots to return (default: 100, max: 1000) | | `entry_id` | string | Yes | ID of the entry to retrieve snapshots for | | `space_id` | string | Yes | ID of the space containing the entry | | `environment_id` | string | Yes | ID of the environment (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Environment **Slug:** `CONTENTFUL_GET_ENVIRONMENT` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the environment | | `environment_id` | string | Yes | ID of the environment to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization **Slug:** `CONTENTFUL_GET_ORGANIZATION` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Access Grant **Slug:** `CONTENTFUL_GET_ORGANIZATION_ACCESS_GRANT` Retrieves the access grant status for a specific organization. Use this to verify whether the authenticated user has access to a specific organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization to check access grant for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations **Slug:** `CONTENTFUL_GET_ORGANIZATIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of organizations to skip for pagination | | `limit` | integer | No | Maximum number of organizations to return (default: 100, max: 1000) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations AI Providers **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_AI_PROVIDERS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization to get AI providers for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization App Actions Categories **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_ACTIONS_CATEGORIES` Retrieves app action categories for a Contentful organization. Use this to discover available app action categories and their parameters. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Event Subscription **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEF_EVENT_SUBSCRIPTION` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition to retrieve the event subscription from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations App Definitions **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS` Retrieves all app definitions for a specific organization. Use when you need to list or discover apps owned by an organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization to retrieve app definitions for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations App Definitions Access Grants **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_ACCESS_GRANTS` Get 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of access grants to skip for pagination | | `limit` | integer | No | Maximum number of access grants to return (default: 100, max: 1000) | | `organization_id` | string | Yes | The ID of the organization | | `app_definition_id` | string | Yes | The ID of the app definition | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Definition Actions **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_ACTIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization | | `app_definition_id` | string | Yes | The ID of the app definition | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Action Details **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_ACTIONS2` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `app_action_id` | string | Yes | The ID of the specific app action to retrieve | | `organization_id` | string | Yes | The ID of the organization that contains the app definition | | `app_definition_id` | string | Yes | The ID of the app definition that contains the action | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Definition App Bundles **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_APP_BUNDLES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition to retrieve bundles for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Definition Functions **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_FUNCTIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization | | `app_definition_id` | string | Yes | The ID of the app definition | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Definition Keys **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_KEYS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition to retrieve keys for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Definition Signing Secret **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_APP_DEFINITIONS_SIGNING_SECRET` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition whose signing secret should be retrieved | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Enablements **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_ENABLEMENTS` Retrieves feature enablements for a specific organization in Contentful. Use this to check which AI and vectorization features are enabled for the organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization to retrieve enablements for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Invitation **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_INVITATIONS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `invitation_id` | string | Yes | The ID of the invitation to retrieve | | `organization_id` | string | Yes | The ID of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Periodic Usages **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_ORGANIZATION_PERIODIC_USAGES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `order` | string | No | Order results by usage | | `metric_in` | string | No | Filter by specific metrics (comma-separated values like 'cma,cpa,gql') | | `dateRange_endAt` | string | No | End date for the date range filter (ISO 8601 format: YYYY-MM-DD) | | `organization_id` | string | Yes | The ID of the organization | | `dateRange_startAt` | string | No | Start date for the date range filter (ISO 8601 format: YYYY-MM-DD) | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Roles **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_ROLES` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization to retrieve roles from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organization Security Contacts **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_SECURITY_CONTACTS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization to retrieve security contacts for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations Space Enablements **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_SPACE_ENABLEMENTS` Retrieves all space enablements for a specific organization. Use when you need to check which features are enabled for spaces within an organization. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization to retrieve space enablements for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations Space Periodic Usages **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_SPACE_PERIODIC_USAGES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `order` | string | No | Order results by usage. Example: 'usage' or '-usage' | | `metric_in` | string | No | Comma-separated list of metrics to filter by (e.g., 'cma,cpa,gql') | | `dateRange.endAt` | string | No | End date for the usage period in ISO 8601 format (e.g., '2020-01-05') | | `organization_id` | string | Yes | The ID of the organization to retrieve space periodic usages for | | `dateRange.startAt` | string | No | Start date for the usage period in ISO 8601 format (e.g., '2020-01-01') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations Taxonomy Concepts **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPTS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of concepts to skip for pagination | | `limit` | integer | No | Maximum number of concepts to return (default: 100, max: 1000) | | `organization_id` | string | Yes | The organization ID to retrieve taxonomy concepts from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Taxonomy Concept Ancestors **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPTS_ANCESTORS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `concept_id` | string | Yes | The ID of the taxonomy concept to retrieve ancestors for | | `organization_id` | string | Yes | The ID of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations Taxonomy Concept Schemes **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of concept schemes to skip for pagination | | `limit` | integer | No | Maximum number of concept schemes to return (default: 100, max: 1000) | | `organization_id` | string | Yes | The ID of the organization to retrieve concept schemes from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Taxonomy Concept Scheme **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMES2` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization that contains the concept scheme | | `concept_scheme_id` | string | Yes | The ID of the taxonomy concept scheme to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations Taxonomy Concept Schemes Total **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMES_TOTAL` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization to retrieve taxonomy concept schemes total for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Organizations Taxonomy Concepts Total **Slug:** `CONTENTFUL_GET_ORGANIZATIONS_TAXONOMY_CONCEPTS_TOTAL` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | The ID of the organization to retrieve taxonomy concepts total for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Release **Slug:** `CONTENTFUL_GET_RELEASE` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space containing the release | | `releases_id` | string | Yes | ID of the release to retrieve | | `environment_id` | string | Yes | ID of the environment containing the release (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get space **Slug:** `CONTENTFUL_GET_SPACE` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space to retrieve | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Space Memberships **Slug:** `CONTENTFUL_GET_SPACE_MEMBERSHIPS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of memberships to skip for pagination | | `limit` | integer | No | Maximum number of memberships to return (default: 25, max: 1000) | | `space_id` | string | Yes | ID of the space to retrieve memberships from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Delivery API Keys **Slug:** `CONTENTFUL_GET_SPACES_API_KEYS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of API keys to skip for pagination | | `limit` | integer | No | Maximum number of API keys to return (default: 100, max: 1000) | | `space_id` | string | Yes | ID of the space to retrieve API keys from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Space Environments **Slug:** `CONTENTFUL_GET_SPACES_ENVIRONMENTS` Retrieves all environments of a space in Contentful. Use this to list all environments (including the master environment) within a specific space. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space to get environments from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List App Installations **Slug:** `CONTENTFUL_GET_SPACES_ENVIRONMENTS_APP_INSTALLATIONS` Lists all app installations in a specific Contentful environment. Use this to discover which apps are currently installed in an environment. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space to retrieve app installations from | | `environment_id` | string | Yes | ID of the environment to retrieve app installations from (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get All Assets **Slug:** `CONTENTFUL_GET_SPACES_ENVIRONMENTS_ASSETS` Retrieves 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of assets to skip for pagination | | `limit` | integer | No | Maximum number of assets to return (default: 100, max: 1000) | | `order` | string | No | Order assets by field (e.g. 'sys.createdAt' or '-sys.createdAt' for descending) | | `space_id` | string | Yes | ID of the space containing the assets | | `environment_id` | string | Yes | ID of the environment containing the assets (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Space Environment Locales **Slug:** `CONTENTFUL_GET_SPACES_ENVIRONMENTS_LOCALES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space to get locales from | | `environment_id` | string | Yes | ID of the environment to get locales from (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get App Installation Functions **Slug:** `CONTENTFUL_GET_SPACES_ENVS_APP_INSTALLATIONS_FUNCTIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | The ID of the Contentful space | | `environment_id` | string | Yes | The ID of the environment (e.g., 'master') | | `app_installation_id` | string | Yes | The ID of the installed app | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Authenticated User **Slug:** `CONTENTFUL_GET_USERS_ME` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List Entries **Slug:** `CONTENTFUL_LIST_ENTRIES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of entries to skip for pagination | | `limit` | integer | No | Maximum number of entries to return per page (default: 100, max: 1000) | | `order` | string | No | Sort results by a specified field (e.g., 'sys.createdAt' or '-fields.name' for reverse order) | | `query` | string | No | Full-text search query to filter entries | | `locale` | string | No | Retrieve content in specified language/region code | | `select` | string | No | Comma-separated list of specific fields to return (e.g., 'sys.id,fields.title'). Supports depth of 2 levels maximum. | | `include` | integer | No | Number of levels to resolve linked entries and assets (0-10, default: 1) | | `space_id` | string | Yes | ID of the space containing the entries | | `content_type` | string | No | Filter entries by content type ID. Required when filtering by custom fields. | | `environment_id` | string | Yes | ID of the environment containing the entries (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### List spaces **Slug:** `CONTENTFUL_LIST_SPACES` Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Number of spaces to skip for pagination | | `limit` | integer | No | Maximum number of spaces to return (default: 100, max: 1000) | | `order` | string | No | Order spaces by field (e.g. 'sys.createdAt' or '-sys.createdAt') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get All Space Roles **Slug:** `CONTENTFUL_LIST_SPACES_ROLES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_id` | string | Yes | ID of the space to retrieve roles from | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Query Asset Collection **Slug:** `CONTENTFUL_QUERY_ASSET_COLLECTION` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `skip` | integer | No | Zero-indexed offset in the collection from which items are fetched. Default is 0 | | `limit` | integer | No | Maximum number of items to fetch. Default is 100, maximum is 1000 | | `order` | array | No | Order specifications to apply on the collection query. Example: ['sys_firstPublishedAt_ASC', 'sys_id_DESC'] | | `where` | object | No | Filter specifications to apply on the collection query (AssetFilter type). Example: {'contentType': 'image/jpeg'} | | `locale` | string | No | Locale for the collection items. If not set, the default locale is used. Example: 'en-US' | | `preview` | boolean | No | When set to true, returns non-published content. Default is false | | `space_id` | string | Yes | ID of the space to query assets from | | `access_token` | string | No | 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. | | `use_fallback_locale` | boolean | No | When set to false, fields without a value in the requested locale return null instead of the fallback locale. Default is true | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Query GraphQL Content Type Collection **Slug:** `CONTENTFUL_QUERY_GRAPHQL_CONTENT_TYPE_COLLECTION` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `query` | string | Yes | 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 } } }' | | `space_id` | string | Yes | ID of the Contentful space | | `variables` | object | No | Optional GraphQL variables for parameterized queries. Used to pass dynamic values to the query (e.g., filters, pagination parameters). Example: {'limit': 10, 'preview': true} | | `access_token` | string | No | Content Delivery API (CDA) access token. If not provided, will attempt to use token from metadata. Required for GraphQL Content API access. | | `environment_id` | string | No | ID of the environment (optional, omit for default environment). Use 'master' for production environment. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update App Definition **Slug:** `CONTENTFUL_UPDATE_APP_DEFINITION` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `src` | string | No | The source URL where the root HTML document of the app is hosted | | `name` | string | No | The name of the app | | `locations` | array | No | Array of location objects specifying where the app will be rendered in the Contentful web app | | `parameters` | object | No | Model for app parameters. | | `organization_id` | string | Yes | The organization ID that owns the app definition | | `app_definition_id` | string | Yes | The app definition ID to update | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Editor Interface **Slug:** `CONTENTFUL_UPDATE_EDITOR_INTERFACE` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `version` | integer | Yes | 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. | | `controls` | array | Yes | Array of control objects defining how each field should be displayed and edited in the Contentful UI | | `space_id` | string | Yes | ID of the space containing the content type | | `environment_id` | string | Yes | ID of the environment containing the content type (typically 'master') | | `content_type_id` | string | Yes | ID of the content type to update the editor interface for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Entry **Slug:** `CONTENTFUL_UPDATE_ENTRY` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `fields` | object | Yes | 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. | | `version` | integer | Yes | 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. | | `entry_id` | string | Yes | ID of the entry to create or update | | `metadata` | object | No | Entry metadata including tags. Example: {'tags': []} or {'tags': [{'sys': {'type': 'Link', 'linkType': 'Tag', 'id': 'tagId'}}]} | | `space_id` | string | Yes | ID of the space containing the entry | | `content_type` | string | Yes | Content type ID for this entry (e.g., 'testArticle', 'blogPost'). Must match an existing content type in the space. | | `environment_id` | string | Yes | ID of the environment containing the entry (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update App Event Subscription **Slug:** `CONTENTFUL_UPDATE_ORGANIZATIONS_APP_DEF_EVENT_SUBSCRIPTION` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `topics` | array | Yes | 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. | | `targetUrl` | string | Yes | Subscription URL that will receive events. Must be a valid HTTPS URL. | | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition to update the event subscription for | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update App Definition Action **Slug:** `CONTENTFUL_UPDATE_ORGANIZATIONS_APP_DEFINITIONS_ACTIONS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `url` | string | Yes | HTTPS URL for the endpoint (required when type is endpoint). Must be a valid HTTPS URL. | | `name` | string | Yes | Updated name of the action | | `type` | string ("endpoint" | "function" | "function-invocation") | Yes | Type of action - must be one of: endpoint (for HTTP endpoints), function (for Contentful functions), or function-invocation (for function invocations) | | `category` | string | Yes | 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. | | `app_action_id` | string | Yes | ID of the app action to update | | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition containing the action | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update App Definition Details **Slug:** `CONTENTFUL_UPDATE_ORGANIZATIONS_APP_DEFINITIONS_DETAILS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition whose details should be updated | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update App Definition Signing Secret **Slug:** `CONTENTFUL_UPDATE_ORGANIZATIONS_APP_DEF_SIGNING_SECRET` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | The signing secret value. Must be a 64-character hexadecimal string used to verify webhook signatures from Contentful. | | `organization_id` | string | Yes | ID of the organization containing the app definition | | `app_definition_id` | string | Yes | ID of the app definition for which to create or update the signing secret | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organization Enablements **Slug:** `CONTENTFUL_UPDATE_ORGANIZATIONS_ENABLEMENTS` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `version` | integer | Yes | 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` | object | Yes | Vectorization configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API. | | `customAiActions` | object | Yes | Custom AI actions configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API. | | `organization_id` | string | Yes | The ID of the organization to update enablements for | | `builtInAiActions` | object | Yes | Built-in AI actions configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organization Security Contact **Slug:** `CONTENTFUL_UPDATE_ORGANIZATIONS_SECURITY_CONTACTS` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `email` | string | Yes | The updated email address for the security contact | | `security_id` | string | Yes | The ID of the security contact to update | | `organization_id` | string | Yes | The ID of the organization | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organizations Taxonomy Concepts **Slug:** `CONTENTFUL_UPDATE_ORGANIZATIONS_TAXONOMY_CONCEPTS` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `uri` | string | No | Optional globally unique identifier (URI) for the concept | | `version` | integer | No | 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. | | `altLabels` | object | No | Alternative labels for the concept with locale as key and array of strings as value (e.g., {'en-US': ['Tech', 'IT']}) | | `notations` | array | No | Formal designations like classification codes | | `prefLabel` | object | Yes | The preferred label for the concept with locale as key (e.g., {'en-US': 'Technology'}). At least one locale is required. | | `concept_id` | string | Yes | User-defined ID for the taxonomy concept to create or update | | `hiddenLabels` | object | No | Hidden labels for searching with locale as key and array of strings as value (e.g., {'en-US': ['Hidden1']}) | | `organization_id` | string | Yes | The organization ID containing the taxonomy concept | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Organizations Taxonomy Concept Schemes **Slug:** `CONTENTFUL_UPDATE_ORGANIZATIONS_TAXONOMY_CONCEPT_SCHEMES` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `uri` | string | No | Optional URI identifier for the concept scheme | | `version` | integer | No | 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. | | `prefLabel` | object | Yes | Localized preferred label for the concept scheme. Keys are locale codes (e.g., 'en-US'), values are the labels in that locale. | | `definition` | object | No | Localized definition for the concept scheme. Keys are locale codes (e.g., 'en-US'), values are the definitions in that locale. | | `organization_id` | string | Yes | The ID of the organization to create/update the concept scheme in | | `concept_scheme_id` | string | Yes | User-defined ID for the concept scheme. This will be used as the unique identifier for the concept scheme. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update space **Slug:** `CONTENTFUL_UPDATE_SPACE` Updates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `name` | string | Yes | New name for the space | | `version` | integer | Yes | 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. | | `space_id` | string | Yes | ID of the space to update | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Tag **Slug:** `CONTENTFUL_UPDATE_SPACES_ENVIRONMENTS_TAGS` Creates 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sys` | object | Yes | System metadata for the tag (must include id and type fields) | | `name` | string | Yes | Display name for the tag | | `tag_id` | string | Yes | ID of the tag to update | | `space_id` | string | Yes | ID of the space containing the tag | | `environment_id` | string | Yes | ID of the environment containing the tag (typically 'master') | | `x_contentful_version` | integer | No | Version of the tag to update (used for optimistic locking). If not provided, the API will use version 1. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Validate Bulk Action **Slug:** `CONTENTFUL_VALIDATE_BULK_ACTION` Tool 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `action` | string ("publish") | No | Enum for bulk action types. | | `entities` | object | Yes | Collection of entities (entries or assets) to validate for bulk action | | `space_id` | string | Yes | ID of the space containing the entries/assets to validate | | `environment_id` | string | Yes | ID of the environment containing the entries/assets to validate (typically 'master') | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not |