# Contentful

Your Toolhouse AI Worker can connect to Contentful using 106 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=contentful).

## Tools (106)

### `Contentful Activate Content Type`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                    | Description                                                                                                                     |
| ----------------- | ------- | :------: | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `version`         | integer |     ✅    | `2`                        | Current version number of the content type (required for optimistic locking). This is sent via the X-Contentful-Version header. |
| `space_id`        | string  |     ✅    | `"oducbj6n3pdj"`           | ID of the space containing the content type                                                                                     |
| `environment_id`  | string  |     ✅    | `"master"`                 | ID of the environment containing the content type (typically 'master')                                                          |
| `content_type_id` | string  |     ✅    | `"7ixuRKZGRD7whAhV9ptGx8"` | ID of the content type to activate (publish)                                                                                    |

***

### `Contentful Archive Asset`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                    | Description                                                                                                 |
| ---------------------- | ------- | :------: | -------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `asset_id`             | string  |     ✅    | `"1CcucbFAomGhaHj6aIHamJ"` | ID of the asset to archive                                                                                  |
| `space_id`             | string  |     ✅    | `"oducbj6n3pdj"`           | ID of the space containing the asset                                                                        |
| `environment_id`       | string  |     ✅    | `"master"`                 | ID of the environment containing the asset (typically 'master')                                             |
| `x_contentful_version` | integer |          | `1`                        | Version number of the asset to archive. If not provided, the current version will be fetched automatically. |

***

### `Contentful Archive Entry`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                   | Description                                                                                                 |
| ---------------------- | ------- | :------: | ------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `entry_id`             | string  |     ✅    | `"eVhywO1hQ7UHsFinvj4Uq"` | ID of the entry to archive                                                                                  |
| `space_id`             | string  |     ✅    | `"oducbj6n3pdj"`          | ID of the space containing the entry                                                                        |
| `environment_id`       | string  |     ✅    | `"master"`                | ID of the environment containing the entry (typically 'master')                                             |
| `X-Contentful-Version` | integer |          | `1`                       | Version of the entry to archive. Required for version control. Use the current version number of the entry. |

***

### `Contentful Archive Release`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                    | Description                                                                         |
| ---------------- | ------- | :------: | -------------------------- | ----------------------------------------------------------------------------------- |
| `version`        | integer |     ✅    | `1`                        | Current version of the release for optimistic locking (X-Contentful-Version header) |
| `space_id`       | string  |     ✅    | `"s3cr4njreqmd"`           | The space identifier                                                                |
| `release_id`     | string  |     ✅    | `"3IiJwbxqFXAQ2KSIa6wvZ7"` | The release identifier to archive                                                   |
| `environment_id` | string  |     ✅    | `"master"`                 | The environment identifier (typically 'master')                                     |

***

### `Contentful Create App Definitions Keys`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                    | Description                                                                                                                                         |
| ------------------- | ------- | :------: | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `jwk`               | object  |          | —                          | JSON Web Key object containing a pre-generated public key to upload. Either this field or generate must be provided.                                |
| `generate`          | boolean |          | —                          | 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  |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition                                                                                                |
| `app_definition_id` | string  |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition to create a key for                                                                                                        |

***

### `Contentful Create Content Type`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                             | Description                                                                                                                                   |
| ---------------- | ------ | :------: | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`           | string |     ✅    | `"Blog Post"`                       | Name of the content type                                                                                                                      |
| `fields`         | array  |     ✅    | —                                   | Array of field definitions for the content type. A content type can have up to 50 fields                                                      |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"`                    | ID of the space where the content type will be created                                                                                        |
| `description`    | string |          | `"A blog post with title and body"` | Description of the content type explaining its purpose                                                                                        |
| `displayField`   | string |          | `"title"`                           | 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 |     ✅    | `"master"`                          | ID of the environment where the content type will be created (typically 'master')                                                             |

***

### `Contentful Create Entry Task`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                                          | Description                                                                       |
| ---------------- | ------ | :------: | ------------------------------------------------ | --------------------------------------------------------------------------------- |
| `body`           | string |     ✅    | `"Review and verify this entry for API testing"` | Description or body content of the task                                           |
| `status`         | string |     ✅    | `"active"`                                       | Status of the task, typically 'active' for new tasks                              |
| `entry_id`       | string |     ✅    | `"36JqANELdH2eIkNdChgNlg"`                       | ID of the entry to create the task for                                            |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"`                                 | ID of the space containing the entry                                              |
| `assignedTo`     | object |     ✅    | —                                                | User to assign the task to, with sys.id, sys.linkType='User', and sys.type='Link' |
| `environment_id` | string |     ✅    | `"master"`                                       | ID of the environment containing the entry (typically 'master')                   |

***

### `Contentful Create Environment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter               | Type   | Required | Example                 | Description                                                                                                                                                                      |
| ----------------------- | ------ | :------: | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                  | string |     ✅    | `"Staging Environment"` | Name of the new environment                                                                                                                                                      |
| `space_id`              | string |     ✅    | `"example_space_id"`    | ID of the space where the environment will be created                                                                                                                            |
| `source_environment_id` | string |          | `"master"`              | 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. |

***

### `Contentful Create Organizations App Def Access Grants`

Integration name: **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).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                                                                       |
| ------------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------------------------------------- |
| `grantee_id`        | string |     ✅    | `"all"`                    | ID of the organization to grant access to, or 'all' to allow all organizations to install the app |
| `grantee_type`      | string |     ✅    | `"Organization"`           | Type of grantee. Must be 'Organization'                                                           |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization that owns the app definition                                           |
| `app_definition_id` | string |     ✅    | `"2u73EcCRI8Tmhp7qrNQyFi"` | The ID of the app definition to grant access to                                                   |

***

### `Contentful Create Organizations App Definitions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                          | Description                                                             |
| ----------------- | ------ | :------: | -------------------------------- | ----------------------------------------------------------------------- |
| `src`             | string |          | `"https://example.com/app.html"` | URL where the root HTML document of the app can be found                |
| `name`            | string |     ✅    | `"Hello world!"`                 | Name of the app definition                                              |
| `locations`       | array  |          | `[{"location":"entry-sidebar"}]` | Locations where the app can be installed and rendered within Contentful |
| `parameters`      | object |          | —                                | Model for app parameters configuration.                                 |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"`       | The ID of the organization where the app definition will be created     |

***

### `Contentful Create Organizations App Definitions Actions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                        | Description                                                                                                                                                            |
| ------------------- | ------ | :------: | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`               | string |          | `"https://example.com/action"` | HTTPS URL for the endpoint (required when type is endpoint). Must be a valid HTTPS URL.                                                                                |
| `name`              | string |     ✅    | `"Test Notification Action"`   | Name of the action to create                                                                                                                                           |
| `type`              | string |     ✅    | —                              | Type of action - must be one of: endpoint (for HTTP endpoints), function (for Contentful functions), or function-invocation (for function invocations)                 |
| `category`          | string |     ✅    | `"Notification.v1.0"`          | 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 |     ✅    | `"3STdL5T2FArlo1qttULwUR"`     | ID of the organization containing the app definition                                                                                                                   |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"`     | ID of the app definition to create an action for                                                                                                                       |

***

### `Contentful Create Organizations Invitations`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                         |
| ----------------- | ------ | :------: | -------------------------- | --------------------------------------------------- |
| `role`            | string |          | `"developer"`              | Enum for invitation role values.                    |
| `email`           | string |     ✅    | `"testuser@example.com"`   | The email address of the person being invited       |
| `lastName`        | string |          | `"User"`                   | The invitee's last name                             |
| `firstName`       | string |          | `"Test"`                   | The invitee's first name                            |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization to create the invitation for |

***

### `Contentful Create Organizations Security Contacts`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                                                                                          |
| ----------------- | ------ | :------: | -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `email`           | string |     ✅    | `"security@example.com"`   | Email address for the security contact. This email will receive security-related notifications for the organization. |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to create a security contact for                                                          |

***

### `Contentful Create Organizations Taxonomy Concepts`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                                    | Description                                                                                                              |
| ---------------- | ------ | :------: | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `uri`            | string |          | `"http://example.com/concepts/technology"` | Optional globally unique identifier (URI) for the concept                                                                |
| `altLabels`      | object |          | `{"en-US":["Tech","IT"]}`                  | Alternative labels for the concept with locale as key and array of strings as value (e.g., {'en-US': \['Tech', 'IT']})   |
| `notations`      | array  |          | `["CODE-001","TECH-A"]`                    | Formal designations like classification codes                                                                            |
| `prefLabel`      | object |     ✅    | `{"en-US":"Technology"}`                   | The preferred label for the concept with locale as key (e.g., {'en-US': 'Technology'}). At least one locale is required. |
| `hiddenLabels`   | object |          | `{"en-US":["Internal Term"]}`              | Hidden labels for searching with locale as key and array of strings as value (e.g., {'en-US': \['Hidden1']})             |
| `organizationId` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"`                 | The organization ID to create the taxonomy concept in                                                                    |

***

### `Contentful Create Organizations Taxonomy Concept Schemes`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                                             | Description                                                                                                                                                                                  |
| ----------------- | ------ | :------: | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uri`             | string |          | `"https://example.com/taxonomy/product-categories"` | Optional URI identifier for the concept scheme                                                                                                                                               |
| `prefLabel`       | object |     ✅    | `{"en-US":"Product Categories"}`                    | 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 |          | `{"en-US":"A classification scheme for products"}`  | 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 |     ✅    | `"3STdL5T2FArlo1qttULwUR"`                          | The ID of the organization to create the concept scheme in                                                                                                                                   |

***

### `Contentful Create Release`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                           | Description                                                                  |
| ---------------- | ------ | :------: | --------------------------------- | ---------------------------------------------------------------------------- |
| `title`          | string |     ✅    | `"Test Release API Verification"` | Title of the release                                                         |
| `entities`       | object |     ✅    | —                                 | Collection of entities (entries/assets) to include in the release            |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"`                  | ID of the space where the release will be created                            |
| `environment_id` | string |     ✅    | `"master"`                        | ID of the environment where the release will be created (typically 'master') |

***

### `Contentful Create Spaces Api Keys`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                             | Description                                                                                                                                   |
| -------------- | ------ | :------: | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`         | string |     ✅    | `"Example API Key"`                                                 | Name for the new API key. This helps identify the key's purpose                                                                               |
| `space_id`     | string |     ✅    | `"oducbj6n3pdj"`                                                    | ID of the space to create the API key in                                                                                                      |
| `description`  | string |          | —                                                                   | Optional description for the API key to explain its purpose or usage                                                                          |
| `environments` | array  |     ✅    | `[{"sys":{"id":"staging","type":"Link","linkType":"Environment"}}]` | 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 |

***

### `Contentful Create Spaces Environments Assets`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example          | Description                                                                                         |
| ---------------- | ------ | :------: | ---------------- | --------------------------------------------------------------------------------------------------- |
| `fields`         | object |     ✅    | —                | Asset fields containing file information and optional title/description with locale-specific values |
| `metadata`       | object |          | —                | Model for asset metadata.                                                                           |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"` | ID of the space where the asset will be created                                                     |
| `environment_id` | string |     ✅    | `"master"`       | ID of the environment where the asset will be created (typically 'master')                          |

***

### `Contentful Create Spaces Environments Entries`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                   | Type   | Required | Example                                     | Description                                                                                                             |
| --------------------------- | ------ | :------: | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `fields`                    | object |     ✅    | `{"title":{"en-US":"Test Entry from API"}}` | Entry fields organized by locale. Structure: {fieldName: {locale: value}}. Example: {'title': {'en-US': 'Hello World'}} |
| `metadata`                  | object |          | —                                           | Entry metadata including tags. Example: {'tags': \[{'sys': {'id': 'nyCampaign', 'linkType': 'Tag', 'type': 'Link'}}]}   |
| `space_id`                  | string |     ✅    | `"oducbj6n3pdj"`                            | ID of the space where the entry will be created                                                                         |
| `environment_id`            | string |     ✅    | `"master"`                                  | ID of the environment where the entry will be created (typically 'master')                                              |
| `X-Contentful-Content-Type` | string |     ✅    | `"testArticle"`                             | Content type ID that defines the structure of the entry being created. Must be a valid content type ID from your space. |

***

### `Contentful Create Spaces Environments Entries Comments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                                                               | Description                                                     |
| ---------------- | ------ | :------: | --------------------------------------------------------------------- | --------------------------------------------------------------- |
| `body`           | string |     ✅    | `"This is a test comment created via API for verification purposes."` | The comment text content to create                              |
| `entry_id`       | string |     ✅    | `"eVhywO1hQ7UHsFinvj4Uq"`                                             | ID of the entry to comment on                                   |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"`                                                      | ID of the space containing the entry                            |
| `environment_id` | string |     ✅    | `"master"`                                                            | ID of the environment containing the entry (typically 'master') |

***

### `Contentful Create Spaces Environments Extensions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example          | Description                                                                             |
| ---------------- | ------ | :------: | ---------------- | --------------------------------------------------------------------------------------- |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"` | ID of the space where the extension will be created                                     |
| `extension`      | object |     ✅    | —                | Extension configuration object containing name, source, field types, and other settings |
| `environment_id` | string |     ✅    | `"master"`       | ID of the environment where the extension will be created (typically 'master')          |

***

### `Contentful Create Spaces Scheduled Actions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example          | Description                                                    |
| -------------- | ------ | :------: | ---------------- | -------------------------------------------------------------- |
| `action`       | string |     ✅    | `"publish"`      | Type of action to schedule (publish or unpublish)              |
| `entity`       | object |     ✅    | —                | Reference to the entry or asset to perform the action on       |
| `space_id`     | string |     ✅    | `"oducbj6n3pdj"` | ID of the space where the scheduled action will be created     |
| `environment`  | object |     ✅    | —                | Reference to the environment where the action will be executed |
| `scheduledFor` | object |     ✅    | —                | Timestamp specification for when to execute the action         |

***

### `Contentful Delete Asset`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                    | Description                                                     |
| ---------------- | ------ | :------: | -------------------------- | --------------------------------------------------------------- |
| `asset_id`       | string |     ✅    | `"5Bw38nJoBckG6hS574RWfx"` | ID of the asset to delete                                       |
| `space_id`       | string |     ✅    | `"s3cr4njreqmd"`           | ID of the space containing the asset                            |
| `environment_id` | string |     ✅    | `"master"`                 | ID of the environment containing the asset (typically 'master') |

***

### `Contentful Delete Content Type`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                   | Description                                                            |
| ----------------- | ------ | :------: | ------------------------- | ---------------------------------------------------------------------- |
| `space_id`        | string |     ✅    | `"s3cr4njreqmd"`          | ID of the space containing the content type                            |
| `environment_id`  | string |     ✅    | `"master"`                | ID of the environment containing the content type (typically 'master') |
| `content_type_id` | string |     ✅    | `"testDeleteContentType"` | ID of the content type to delete                                       |

***

### `Contentful Delete Entry`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example              | Description                                                     |
| ---------------- | ------ | :------: | -------------------- | --------------------------------------------------------------- |
| `entry_id`       | string |     ✅    | `"example_entry_id"` | ID of the entry to delete                                       |
| `space_id`       | string |     ✅    | `"example_space_id"` | ID of the space containing the entry                            |
| `environment_id` | string |     ✅    | `"master"`           | ID of the environment containing the entry (typically 'master') |

***

### `Contentful Delete Environment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example          | Description                                                               |
| ---------------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------- |
| `space_id`       | string |     ✅    | `"s3cr4njreqmd"` | ID of the space containing the environment                                |
| `environment_id` | string |     ✅    | `"master"`       | ID of the environment to delete (e.g., 'master' or custom environment ID) |

***

### `Contentful Delete Extension`

Integration name: **CONTENTFUL\_DELETE\_EXTENSION**

Deletes an extension by ID from a Contentful environment. Use this when you need to permanently remove an extension.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                    | Description                                                         |
| ---------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------- |
| `space_id`       | string |     ✅    | `"s3cr4njreqmd"`           | ID of the space containing the extension                            |
| `extension_id`   | string |     ✅    | `"3mjyHM3AmDoDjOpRUdALwM"` | ID of the extension to delete                                       |
| `environment_id` | string |     ✅    | `"master"`                 | ID of the environment containing the extension (typically 'master') |

***

### `Contentful Delete Organizations App Def Event Subscription`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                                    |
| ------------------- | ------ | :------: | -------------------------- | -------------------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition           |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition to delete the event subscription from |

***

### `Contentful Delete Organizations App Definitions Details`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                              |
| ------------------- | ------ | :------: | -------------------------- | -------------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition     |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition whose details should be deleted |

***

### `Contentful Delete Organizations App Definitions Keys`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                                         | Description                                          |
| ------------------- | ------ | :------: | ----------------------------------------------- | ---------------------------------------------------- |
| `key_kid`           | string |     ✅    | `"1Ut99jPN_e6kot2N49Ro60t3sTCiAtcdgZiqY2zipb8"` | Key ID (kid) of the app key to delete                |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"`                      | ID of the organization containing the app definition |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"`                      | ID of the app definition containing the key          |

***

### `Contentful Delete Organizations App Def Signing Secret`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                                     |
| ------------------- | ------ | :------: | -------------------------- | --------------------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition            |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition whose signing secret should be removed |

***

### `Contentful Delete Organizations Security Contacts`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                              |
| ----------------- | ------ | :------: | -------------------------- | ---------------------------------------- |
| `contact_id`      | string |     ✅    | `"032rm42WuoqemsuCP6R0d7"` | The ID of the security contact to delete |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization               |

***

### `Contentful Delete Release`

Integration name: **CONTENTFUL\_DELETE\_RELEASE**

Deletes a release by ID from a Contentful environment. Use this when you need to permanently remove a release.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                    | Description                                                       |
| ---------------- | ------ | :------: | -------------------------- | ----------------------------------------------------------------- |
| `space_id`       | string |     ✅    | `"s3cr4njreqmd"`           | ID of the space containing the release                            |
| `releases_id`    | string |     ✅    | `"52zMNW62vuupwBK1veGGYG"` | ID of the release to delete                                       |
| `environment_id` | string |     ✅    | `"master"`                 | ID of the environment containing the release (typically 'master') |

***

### `Contentful Delete Scheduled Action`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type   | Required | Example                    | Description                                                                                                         |
| --------------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `space_id`            | string |     ✅    | `"s3cr4njreqmd"`           | ID of the space containing the scheduled action                                                                     |
| `environment_sys_id`  | string |     ✅    | `"master"`                 | ID of the environment (typically 'master'). Required to identify which environment the scheduled action belongs to. |
| `scheduled_action_id` | string |     ✅    | `"34mJ5kfkagNoQdO5q28Uma"` | ID of the scheduled action to cancel                                                                                |

***

### `Contentful Delete Space Membership`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type   | Required | Example                    | Description                               |
| --------------------- | ------ | :------: | -------------------------- | ----------------------------------------- |
| `space_id`            | string |     ✅    | `"s3cr4njreqmd"`           | ID of the space containing the membership |
| `space_membership_id` | string |     ✅    | `"44JMMLWjG39JFB8qYgjd7O"` | ID of the space membership to delete      |

***

### `Contentful Delete Spaces Api Keys`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                    | Description                                                                                                                       |
| ---------------------- | ------- | :------: | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `space_id`             | string  |     ✅    | `"s3cr4njreqmd"`           | ID of the space containing the API key                                                                                            |
| `api_key_id`           | string  |     ✅    | `"032rm3escXRfRqm1w21rES"` | ID of the API key to delete                                                                                                       |
| `x_contentful_version` | integer |          | `1`                        | Version number for optimistic locking. If provided, the API key will only be deleted if this version matches the current version. |

***

### `Contentful Delete Spaces Upload`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                   | Description                           |
| ----------- | ------ | :------: | ------------------------- | ------------------------------------- |
| `space_id`  | string |     ✅    | `"oducbj6n3pdj"`          | ID of the space containing the upload |
| `upload_id` | string |     ✅    | `"A6KQl2JrqjkFkQ5OL1C6e"` | ID of the upload to delete            |

***

### `Contentful Delete Tag`

Integration name: **CONTENTFUL\_DELETE\_TAG**

Deletes a tag by ID from a Contentful environment. Use this when you need to permanently remove a tag.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example         | Description                                                          |
| ---------------------- | ------- | :------: | --------------- | -------------------------------------------------------------------- |
| `tag_id`               | string  |     ✅    | `"testTag2"`    | ID of the tag to delete                                              |
| `space_id`             | string  |     ✅    | `"my_space_id"` | ID of the space containing the tag                                   |
| `environment_id`       | string  |     ✅    | `"master"`      | ID of the environment containing the tag (typically 'master')        |
| `x_contentful_version` | integer |          | `1`             | Version of the tag to delete (optional, used for optimistic locking) |

***

### `Contentful Get App Bundle`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                          |
| ------------------- | ------ | :------: | -------------------------- | ---------------------------------------------------- |
| `bundle_id`         | string |     ✅    | `"tYbPxzOG3XaR4k2aRnvxI"`  | ID of the app bundle to retrieve                     |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition containing the bundle       |

***

### `Contentful Get App Definition`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                      |
| ------------------- | ------ | :------: | -------------------------- | ------------------------------------------------ |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The organization ID that owns the app definition |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | The app definition ID to retrieve                |

***

### `Contentful Get Asset`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                    | Description                                                     |
| ---------------- | ------ | :------: | -------------------------- | --------------------------------------------------------------- |
| `asset_id`       | string |     ✅    | `"2Cry0DIW629eUrVc9gZQHo"` | ID of the asset to retrieve                                     |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"`           | ID of the space containing the asset                            |
| `environment_id` | string |     ✅    | `"master"`                 | ID of the environment containing the asset (typically 'master') |

***

### `Contentful Get Content Types`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example          | Description                                                                            |
| ---------------- | ------- | :------: | ---------------- | -------------------------------------------------------------------------------------- |
| `skip`           | integer |          | —                | Number of content types to skip for pagination                                         |
| `limit`          | integer |          | —                | Maximum number of content types to return (default: 100, max: 1000)                    |
| `order`          | string  |          | —                | Order content types by field (e.g. 'sys.createdAt' or '-sys.createdAt' for descending) |
| `space_id`       | string  |     ✅    | `"oducbj6n3pdj"` | ID of the space containing the content types                                           |
| `environment_id` | string  |     ✅    | `"master"`       | ID of the environment containing the content types (typically 'master')                |

***

### `Contentful Get Content Type Snapshot`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                     |
| ----------------- | ------ | :------: | -------------------------- | ----------------------------------------------- |
| `space_id`        | string |     ✅    | `"oducbj6n3pdj"`           | ID of the space containing the content type     |
| `snapshot_id`     | string |     ✅    | `"69D3tgO2qwAw6bPAX8jxn3"` | ID of the snapshot to retrieve                  |
| `content_type_id` | string |     ✅    | `"testArticle"`            | ID of the content type to retrieve snapshot for |

***

### `Contentful Get Content Type Snapshots`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example          | Description                                                     |
| ----------------- | ------- | :------: | ---------------- | --------------------------------------------------------------- |
| `skip`            | integer |          | —                | Number of snapshots to skip for pagination                      |
| `limit`           | integer |          | —                | Maximum number of snapshots to return (default: 100, max: 1000) |
| `space_id`        | string  |     ✅    | `"oducbj6n3pdj"` | ID of the space containing the content type                     |
| `environment_id`  | string  |     ✅    | `"master"`       | ID of the environment (typically 'master')                      |
| `content_type_id` | string  |     ✅    | `"testArticle"`  | ID of the content type to retrieve snapshots for                |

***

### `Contentful Get Editor Interface`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example              | Description                                                            |
| ----------------- | ------ | :------: | -------------------- | ---------------------------------------------------------------------- |
| `space_id`        | string |     ✅    | `"example_space_id"` | ID of the space containing the content type                            |
| `environment_id`  | string |     ✅    | `"master"`           | ID of the environment containing the content type (typically 'master') |
| `content_type_id` | string |     ✅    | `"testArticle"`      | ID of the content type to get the editor interface for                 |

***

### `Contentful Get Entry Comment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                    | Description                                                     |
| ---------------- | ------ | :------: | -------------------------- | --------------------------------------------------------------- |
| `entry_id`       | string |     ✅    | `"36JqANELdH2eIkNdChgNlg"` | ID of the entry containing the comment                          |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"`           | ID of the space containing the entry                            |
| `comment_id`     | string |     ✅    | `"7l6fAw5NDGXkdBOpqesW4X"` | ID of the comment to retrieve                                   |
| `environment_id` | string |     ✅    | `"master"`                 | ID of the environment containing the entry (typically 'master') |

***

### `Contentful Get Entry References`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                    | Description                                                                                                  |
| ---------------- | ------- | :------: | -------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `include`        | integer |     ✅    | `1`                        | Level of referenced content to include in the response (0-10). Higher values include more nested references. |
| `entry_id`       | string  |     ✅    | `"36JqANELdH2eIkNdChgNlg"` | ID of the entry to get references for                                                                        |
| `space_id`       | string  |     ✅    | `"oducbj6n3pdj"`           | ID of the space containing the entry                                                                         |
| `environment_id` | string  |     ✅    | `"master"`                 | ID of the environment containing the entry (typically 'master')                                              |

***

### `Contentful Get Entry Snapshots`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                    | Description                                                     |
| ---------------- | ------- | :------: | -------------------------- | --------------------------------------------------------------- |
| `skip`           | integer |          | —                          | Number of snapshots to skip for pagination                      |
| `limit`          | integer |          | —                          | Maximum number of snapshots to return (default: 100, max: 1000) |
| `entry_id`       | string  |     ✅    | `"36JqANELdH2eIkNdChgNlg"` | ID of the entry to retrieve snapshots for                       |
| `space_id`       | string  |     ✅    | `"oducbj6n3pdj"`           | ID of the space containing the entry                            |
| `environment_id` | string  |     ✅    | `"master"`                 | ID of the environment (typically 'master')                      |

***

### `Contentful Get Environment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example              | Description                                |
| ---------------- | ------ | :------: | -------------------- | ------------------------------------------ |
| `space_id`       | string |     ✅    | `"example_space_id"` | ID of the space containing the environment |
| `environment_id` | string |     ✅    | `"master"`           | ID of the environment to retrieve          |

***

### `Contentful Get Organization`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                            |
| ----------------- | ------ | :------: | -------------------------- | -------------------------------------- |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve |

***

### `Contentful Get Organization Access Grant`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                      |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------------------ |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization to check access grant for |

***

### `Contentful Get Organizations`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                         |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------- |
| `skip`    | integer |          | —       | Number of organizations to skip for pagination                      |
| `limit`   | integer |          | —       | Maximum number of organizations to return (default: 100, max: 1000) |

***

### `Contentful Get Organizations Ai Providers`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                    |
| ----------------- | ------ | :------: | -------------------------- | ---------------------------------------------- |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization to get AI providers for |

***

### `Contentful Get Organizations App Actions Categories`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                |
| ----------------- | ------ | :------: | -------------------------- | -------------------------- |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization |

***

### `Contentful Get Organizations App Def Event Subscription`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                                      |
| ------------------- | ------ | :------: | -------------------------- | ---------------------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition             |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition to retrieve the event subscription from |

***

### `Contentful Get Organizations App Definitions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                            |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------------------------ |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization to retrieve app definitions for |

***

### `Contentful Get Organizations App Definitions Access Grants`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                    | Description                                                         |
| ------------------- | ------- | :------: | -------------------------- | ------------------------------------------------------------------- |
| `skip`              | integer |          | —                          | Number of access grants to skip for pagination                      |
| `limit`             | integer |          | —                          | Maximum number of access grants to return (default: 100, max: 1000) |
| `organization_id`   | string  |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization                                          |
| `app_definition_id` | string  |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | The ID of the app definition                                        |

***

### `Contentful Get Organizations App Definitions Actions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                  |
| ------------------- | ------ | :------: | -------------------------- | ---------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization   |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | The ID of the app definition |

***

### `Contentful Get Organizations App Definitions Actions2`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                                 |
| ------------------- | ------ | :------: | -------------------------- | ----------------------------------------------------------- |
| `app_action_id`     | string |     ✅    | `"B6z8wRlwRlmZLiMTtYVGx"`  | The ID of the specific app action to retrieve               |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization that contains the app definition |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | The ID of the app definition that contains the action       |

***

### `Contentful Get Organizations App Definitions App Bundles`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                          |
| ------------------- | ------ | :------: | -------------------------- | ---------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition to retrieve bundles for     |

***

### `Contentful Get Organizations App Definitions Functions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                  |
| ------------------- | ------ | :------: | -------------------------- | ---------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization   |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | The ID of the app definition |

***

### `Contentful Get Organizations App Definitions Keys`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                          |
| ------------------- | ------ | :------: | -------------------------- | ---------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition to retrieve keys for        |

***

### `Contentful Get Organizations App Definitions Signing Secret`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                                       |
| ------------------- | ------ | :------: | -------------------------- | ----------------------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition              |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | ID of the app definition whose signing secret should be retrieved |

***

### `Contentful Get Organizations Enablements`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                            |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------------------------ |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve enablements for |

***

### `Contentful Get Organizations Invitations`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                          |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------ |
| `invitation_id`   | string |     ✅    | `"032rmb30jmBsZtn97YXWFZ"` | The ID of the invitation to retrieve |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization           |

***

### `Contentful Get Organizations Organization Periodic Usages`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type   | Required | Example                    | Description                                                            |
| --------------------- | ------ | :------: | -------------------------- | ---------------------------------------------------------------------- |
| `order`               | string |          | `"usage"`                  | Order results by usage                                                 |
| `metric_in`           | string |          | `"cma,cpa,gql"`            | Filter by specific metrics (comma-separated values like 'cma,cpa,gql') |
| `organization_id`     | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization                                             |
| `date_range_end_at`   | string |          | `"2020-01-05"`             | End date for the date range filter (ISO 8601 format: YYYY-MM-DD)       |
| `date_range_start_at` | string |          | `"2020-01-01"`             | Start date for the date range filter (ISO 8601 format: YYYY-MM-DD)     |

***

### `Contentful Get Organizations Roles`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                       |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------------------- |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve roles from |

***

### `Contentful Get Organizations Security Contacts`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                                  |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------ |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve security contacts for |

***

### `Contentful Get Organizations Space Enablements`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                                  |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------ |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve space enablements for |

***

### `Contentful Get Organizations Space Periodic Usages`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                                             |
| ------------------- | ------ | :------: | -------------------------- | ----------------------------------------------------------------------- |
| `order`             | string |          | `"usage"`                  | Order results by usage. Example: 'usage' or '-usage'                    |
| `metric_in`         | string |          | `"cma,cpa,gql"`            | Comma-separated list of metrics to filter by (e.g., 'cma,cpa,gql')      |
| `dateRange.endAt`   | string |          | `"2020-01-05"`             | End date for the usage period in ISO 8601 format (e.g., '2020-01-05')   |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve space periodic usages for        |
| `dateRange.startAt` | string |          | `"2020-01-01"`             | Start date for the usage period in ISO 8601 format (e.g., '2020-01-01') |

***

### `Contentful Get Organizations Taxonomy Concepts`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                    | Description                                                    |
| ----------------- | ------- | :------: | -------------------------- | -------------------------------------------------------------- |
| `skip`            | integer |          | —                          | Number of concepts to skip for pagination                      |
| `limit`           | integer |          | —                          | Maximum number of concepts to return (default: 100, max: 1000) |
| `organization_id` | string  |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The organization ID to retrieve taxonomy concepts from         |

***

### `Contentful Get Organizations Taxonomy Concepts Ancestors`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                              |
| ----------------- | ------ | :------: | -------------------------- | -------------------------------------------------------- |
| `concept_id`      | string |     ✅    | `"3o7r74hE0hwugew3RYeHvf"` | The ID of the taxonomy concept to retrieve ancestors for |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization                               |

***

### `Contentful Get Organizations Taxonomy Concept Schemes`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                    | Description                                                           |
| ----------------- | ------- | :------: | -------------------------- | --------------------------------------------------------------------- |
| `skip`            | integer |          | —                          | Number of concept schemes to skip for pagination                      |
| `limit`           | integer |          | —                          | Maximum number of concept schemes to return (default: 100, max: 1000) |
| `organization_id` | string  |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve concept schemes from           |

***

### `Contentful Get Organizations Taxonomy Concept Schemes2`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                                 |
| ------------------- | ------ | :------: | -------------------------- | ----------------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization that contains the concept scheme |
| `concept_scheme_id` | string |     ✅    | `"4WfLGnn49Iv4uBx6HJRFwo"` | The ID of the taxonomy concept scheme to retrieve           |

***

### `Contentful Get Organizations Taxonomy Concept Schemes Total`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                                               |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------------- |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve taxonomy concept schemes total for |

***

### `Contentful Get Organizations Taxonomy Concepts Total`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                    | Description                                                        |
| ----------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------ |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to retrieve taxonomy concepts total for |

***

### `Contentful Get Release`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                    | Description                                                       |
| ---------------- | ------ | :------: | -------------------------- | ----------------------------------------------------------------- |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"`           | ID of the space containing the release                            |
| `releases_id`    | string |     ✅    | `"6ycVQCaGvvpaO3OxlNCtfz"` | ID of the release to retrieve                                     |
| `environment_id` | string |     ✅    | `"master"`                 | ID of the environment containing the release (typically 'master') |

***

### `Contentful Get Space`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example              | Description                 |
| ---------- | ------ | :------: | -------------------- | --------------------------- |
| `space_id` | string |     ✅    | `"example_space_id"` | ID of the space to retrieve |

***

### `Contentful Get Space Memberships`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type    | Required | Example          | Description                                                      |
| ---------- | ------- | :------: | ---------------- | ---------------------------------------------------------------- |
| `skip`     | integer |          | —                | Number of memberships to skip for pagination                     |
| `limit`    | integer |          | —                | Maximum number of memberships to return (default: 25, max: 1000) |
| `space_id` | string  |     ✅    | `"5nvk6q4s3ttw"` | ID of the space to retrieve memberships from                     |

***

### `Contentful Get Spaces Api Keys`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type    | Required | Example          | Description                                                    |
| ---------- | ------- | :------: | ---------------- | -------------------------------------------------------------- |
| `skip`     | integer |          | —                | Number of API keys to skip for pagination                      |
| `limit`    | integer |          | —                | Maximum number of API keys to return (default: 100, max: 1000) |
| `space_id` | string  |     ✅    | `"oducbj6n3pdj"` | ID of the space to retrieve API keys from                      |

***

### `Contentful Get Spaces Environments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example          | Description                              |
| ---------- | ------ | :------: | ---------------- | ---------------------------------------- |
| `space_id` | string |     ✅    | `"oducbj6n3pdj"` | ID of the space to get environments from |

***

### `Contentful Get Spaces Environments App Installations`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example          | Description                                                                   |
| ---------------- | ------ | :------: | ---------------- | ----------------------------------------------------------------------------- |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"` | ID of the space to retrieve app installations from                            |
| `environment_id` | string |     ✅    | `"master"`       | ID of the environment to retrieve app installations from (typically 'master') |

***

### `Contentful Get Spaces Environments Assets`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example          | Description                                                                     |
| ---------------- | ------- | :------: | ---------------- | ------------------------------------------------------------------------------- |
| `skip`           | integer |          | —                | Number of assets to skip for pagination                                         |
| `limit`          | integer |          | —                | Maximum number of assets to return (default: 100, max: 1000)                    |
| `order`          | string  |          | —                | Order assets by field (e.g. 'sys.createdAt' or '-sys.createdAt' for descending) |
| `space_id`       | string  |     ✅    | `"oducbj6n3pdj"` | ID of the space containing the assets                                           |
| `environment_id` | string  |     ✅    | `"master"`       | ID of the environment containing the assets (typically 'master')                |

***

### `Contentful Get Spaces Environments Locales`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example          | Description                                                    |
| ---------------- | ------ | :------: | ---------------- | -------------------------------------------------------------- |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"` | ID of the space to get locales from                            |
| `environment_id` | string |     ✅    | `"master"`       | ID of the environment to get locales from (typically 'master') |

***

### `Contentful Get Spaces Envs App Installations Functions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type   | Required | Example                    | Description                                |
| --------------------- | ------ | :------: | -------------------------- | ------------------------------------------ |
| `space_id`            | string |     ✅    | `"oducbj6n3pdj"`           | The ID of the Contentful space             |
| `environment_id`      | string |     ✅    | `"master"`                 | The ID of the environment (e.g., 'master') |
| `app_installation_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"` | The ID of the installed app                |

***

### `Contentful Get Users Me`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Contentful List Entries`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                 | Description                                                                                                          |
| ---------------- | ------- | :------: | ----------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `skip`           | integer |          | —                       | Number of entries to skip for pagination                                                                             |
| `limit`          | integer |          | —                       | Maximum number of entries to return per page (default: 100, max: 1000)                                               |
| `order`          | string  |          | `"sys.createdAt"`       | Sort results by a specified field (e.g., 'sys.createdAt' or '-fields.name' for reverse order)                        |
| `query`          | string  |          | `"search term"`         | Full-text search query to filter entries                                                                             |
| `locale`         | string  |          | `"en-US"`               | Retrieve content in specified language/region code                                                                   |
| `select`         | string  |          | `"sys.id,fields.title"` | Comma-separated list of specific fields to return (e.g., 'sys.id,fields.title'). Supports depth of 2 levels maximum. |
| `include`        | integer |          | —                       | Number of levels to resolve linked entries and assets (0-10, default: 1)                                             |
| `space_id`       | string  |     ✅    | `"example_space_id"`    | ID of the space containing the entries                                                                               |
| `content_type`   | string  |          | `"product"`             | Filter entries by content type ID. Required when filtering by custom fields.                                         |
| `environment_id` | string  |     ✅    | `"master"`              | ID of the environment containing the entries (typically 'master')                                                    |

***

### `Contentful List Spaces`

Integration name: **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`.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                      |
| --------- | ------- | :------: | ------- | ---------------------------------------------------------------- |
| `skip`    | integer |          | —       | Number of spaces to skip for pagination                          |
| `limit`   | integer |          | —       | Maximum number of spaces to return (default: 100, max: 1000)     |
| `order`   | string  |          | —       | Order spaces by field (e.g. 'sys.createdAt' or '-sys.createdAt') |

***

### `Contentful List Spaces Roles`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example          | Description                            |
| ---------- | ------ | :------: | ---------------- | -------------------------------------- |
| `space_id` | string |     ✅    | `"oducbj6n3pdj"` | ID of the space to retrieve roles from |

***

### `Contentful Publish Entry`

Integration name: **CONTENTFUL\_PUBLISH\_ENTRY**

Tool to publish an entry in Contentful, making it available via the Content Delivery API. Use when you need to make an entry publicly accessible or move it from draft to published status. The entry must not be archived and should have all required fields completed. Publishing increments the entry version.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                   | Description                                                                                                 |
| ---------------------- | ------- | :------: | ------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `entry_id`             | string  |     ✅    | `"eVhywO1hQ7UHsFinvj4Uq"` | ID of the entry to publish                                                                                  |
| `space_id`             | string  |     ✅    | `"oducbj6n3pdj"`          | ID of the space containing the entry                                                                        |
| `environment_id`       | string  |     ✅    | `"master"`                | ID of the environment containing the entry (typically 'master')                                             |
| `X-Contentful-Version` | integer |          | `1`                       | Version of the entry to publish. Required for version control. Use the current version number of the entry. |

***

### `Contentful Query Asset Collection`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type    | Required | Example                 | Description                                                                                                                                                                                |
| --------------------- | ------- | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `skip`                | integer |          | —                       | Zero-indexed offset in the collection from which items are fetched. Default is 0                                                                                                           |
| `limit`               | integer |          | —                       | Maximum number of items to fetch. Default is 100, maximum is 1000                                                                                                                          |
| `order`               | array   |          | —                       | Order specifications to apply on the collection query. Example: \['sys\_firstPublishedAt\_ASC', 'sys\_id\_DESC']                                                                           |
| `where`               | object  |          | —                       | Filter specifications to apply on the collection query (AssetFilter type). Example: {'contentType': 'image/jpeg'}                                                                          |
| `locale`              | string  |          | `"en-US"`               | Locale for the collection items. If not set, the default locale is used. Example: 'en-US'                                                                                                  |
| `preview`             | boolean |          | —                       | When set to true, returns non-published content. Default is false                                                                                                                          |
| `space_id`            | string  |     ✅    | `"oducbj6n3pdj"`        | ID of the space to query assets from                                                                                                                                                       |
| `access_token`        | string  |          | `"your_cda_token_here"` | 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 |          | —                       | When set to false, fields without a value in the requested locale return null instead of the fallback locale. Default is true                                                              |

***

### `Contentful Query Graphql Content Type Collection`

Integration name: **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').

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                                                                  | Description                                                                                                                                                                                                                                                       |
| ---------------- | ------ | :------: | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string |     ✅    | `"{ testArticleCollection { items { sys { id publishedAt } title } } }"` | 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 |     ✅    | `"oducbj6n3pdj"`                                                         | ID of the Contentful space                                                                                                                                                                                                                                        |
| `variables`      | object |          | `{"skip":0,"limit":10}`                                                  | 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 |          | `"your_cda_token_here"`                                                  | 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 |          | `"master"`                                                               | ID of the environment (optional, omit for default environment). Use 'master' for production environment.                                                                                                                                                          |

***

### `Contentful Update App Definition`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                                          | Description                                                                                   |
| ------------------- | ------ | :------: | ------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| `src`               | string |          | `"https://example.com/test-updated-app-v2.html"` | The source URL where the root HTML document of the app is hosted                              |
| `name`              | string |          | `"Test Updated App v2"`                          | The name of the app                                                                           |
| `locations`         | array  |          | —                                                | Array of location objects specifying where the app will be rendered in the Contentful web app |
| `parameters`        | object |          | —                                                | Model for app parameters.                                                                     |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"`                       | The organization ID that owns the app definition                                              |
| `app_definition_id` | string |     ✅    | `"2u73EcCRI8Tmhp7qrNQyFi"`                       | The app definition ID to update                                                               |

***

### `Contentful Update Editor Interface`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example              | Description                                                                                                                                                                            |
| ----------------- | ------- | :------: | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `version`         | integer |     ✅    | `1`                  | 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   |     ✅    | —                    | Array of control objects defining how each field should be displayed and edited in the Contentful UI                                                                                   |
| `space_id`        | string  |     ✅    | `"example_space_id"` | ID of the space containing the content type                                                                                                                                            |
| `environment_id`  | string  |     ✅    | `"master"`           | ID of the environment containing the content type (typically 'master')                                                                                                                 |
| `content_type_id` | string  |     ✅    | `"testArticle"`      | ID of the content type to update the editor interface for                                                                                                                              |

***

### `Contentful Update Entry`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                               | Description                                                                                                                                                                                                                                          |
| ---------------- | ------- | :------: | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fields`         | object  |     ✅    | `{"title":{"en-US":"Hello, World!"}}` | 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 |     ✅    | `5`                                   | 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  |     ✅    | `"36JqANELdH2eIkNdChgNlg"`            | ID of the entry to create or update                                                                                                                                                                                                                  |
| `metadata`       | object  |          | `{"tags":[]}`                         | Entry metadata including tags. Example: {'tags': \[]} or {'tags': \[{'sys': {'type': 'Link', 'linkType': 'Tag', 'id': 'tagId'}}]}                                                                                                                    |
| `space_id`       | string  |     ✅    | `"oducbj6n3pdj"`                      | ID of the space containing the entry                                                                                                                                                                                                                 |
| `content_type`   | string  |     ✅    | `"testArticle"`                       | Content type ID for this entry (e.g., 'testArticle', 'blogPost'). Must match an existing content type in the space.                                                                                                                                  |
| `environment_id` | string  |     ✅    | `"master"`                            | ID of the environment containing the entry (typically 'master')                                                                                                                                                                                      |

***

### `Contentful Update Organizations App Def Event Subscription`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                           | Description                                                                                                                                              |
| ------------------- | ------ | :------: | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `topics`            | array  |     ✅    | `["Entry.create","Entry.update"]` | 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 |     ✅    | `"https://example.com/webhook"`   | Subscription URL that will receive events. Must be a valid HTTPS URL.                                                                                    |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"`        | ID of the organization containing the app definition                                                                                                     |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"`        | ID of the app definition to update the event subscription for                                                                                            |

***

### `Contentful Update Organizations App Definitions Actions`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                                | Description                                                                                                                                                            |
| ------------------- | ------ | :------: | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`               | string |     ✅    | `"https://example.com/updated-action"` | HTTPS URL for the endpoint (required when type is endpoint). Must be a valid HTTPS URL.                                                                                |
| `name`              | string |     ✅    | `"Updated Test Notification Action"`   | Updated name of the action                                                                                                                                             |
| `type`              | string |     ✅    | —                                      | Type of action - must be one of: endpoint (for HTTP endpoints), function (for Contentful functions), or function-invocation (for function invocations)                 |
| `category`          | string |     ✅    | `"Notification.v1.0"`                  | 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 |     ✅    | `"4Y9TfktNPsiaG0cP0Ws2w1"`             | ID of the app action to update                                                                                                                                         |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"`             | ID of the organization containing the app definition                                                                                                                   |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"`             | ID of the app definition containing the action                                                                                                                         |

***

### `Contentful Update Organizations App Definitions Details`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                    | Description                                              |
| ------------------- | ------ | :------: | -------------------------- | -------------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | ID of the organization containing the app definition     |
| `app_definition_id` | string |     ✅    | `"2u73EcCRI8Tmhp7qrNQyFi"` | ID of the app definition whose details should be updated |

***

### `Contentful Update Organizations App Def Signing Secret`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                                                              | Description                                                                                                            |
| ------------------- | ------ | :------: | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `value`             | string |     ✅    | `"abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789"` | The signing secret value. Must be a 64-character hexadecimal string used to verify webhook signatures from Contentful. |
| `organization_id`   | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"`                                           | ID of the organization containing the app definition                                                                   |
| `app_definition_id` | string |     ✅    | `"4m36R4p7HfjSiIzB61kxjS"`                                           | ID of the app definition for which to create or update the signing secret                                              |

***

### `Contentful Update Organizations Enablements`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                    | Description                                                                                                                                                    |
| ------------------ | ------- | :------: | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `version`          | integer |     ✅    | `1`                        | 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  |     ✅    | —                          | Vectorization configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API.                           |
| `customAiActions`  | object  |     ✅    | —                          | Custom AI actions configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API.                       |
| `organization_id`  | string  |     ✅    | `"3STdL5T2FArlo1qttULwUR"` | The ID of the organization to update enablements for                                                                                                           |
| `builtInAiActions` | object  |     ✅    | —                          | Built-in AI actions configuration. All three enablement fields (builtInAiActions, customAiActions, vectorization) are required by the API.                     |

***

### `Contentful Update Organizations Security Contacts`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                          | Description                                        |
| ----------------- | ------ | :------: | -------------------------------- | -------------------------------------------------- |
| `email`           | string |     ✅    | `"updated-security@example.com"` | The updated email address for the security contact |
| `security_id`     | string |     ✅    | `"032rmbYRhRXzY4CVlKBOl8"`       | The ID of the security contact to update           |
| `organization_id` | string |     ✅    | `"3STdL5T2FArlo1qttULwUR"`       | The ID of the organization                         |

***

### `Contentful Update Organizations Taxonomy Concepts`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                                    | Description                                                                                                                                                                                                |
| ----------------- | ------- | :------: | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uri`             | string  |          | `"http://example.com/concepts/technology"` | Optional globally unique identifier (URI) for the concept                                                                                                                                                  |
| `version`         | integer |          | `1`                                        | 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  |          | `{"en-US":["Tech","IT"]}`                  | Alternative labels for the concept with locale as key and array of strings as value (e.g., {'en-US': \['Tech', 'IT']})                                                                                     |
| `notations`       | array   |          | `["CODE-001","TECH-A"]`                    | Formal designations like classification codes                                                                                                                                                              |
| `prefLabel`       | object  |     ✅    | `{"en-US":"Test Concept"}`                 | The preferred label for the concept with locale as key (e.g., {'en-US': 'Technology'}). At least one locale is required.                                                                                   |
| `concept_id`      | string  |     ✅    | `"test-concept-001"`                       | User-defined ID for the taxonomy concept to create or update                                                                                                                                               |
| `hiddenLabels`    | object  |          | `{"en-US":["Internal Term"]}`              | Hidden labels for searching with locale as key and array of strings as value (e.g., {'en-US': \['Hidden1']})                                                                                               |
| `organization_id` | string  |     ✅    | `"3STdL5T2FArlo1qttULwUR"`                 | The organization ID containing the taxonomy concept                                                                                                                                                        |

***

### `Contentful Update Organizations Taxonomy Concept Schemes`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                                            | Description                                                                                                                                                                 |
| ------------------- | ------- | :------: | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uri`               | string  |          | `"http://example.com/schemes/products"`            | Optional URI identifier for the concept scheme                                                                                                                              |
| `version`           | integer |          | `1`                                                | 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  |     ✅    | `{"en-US":"Product Categories"}`                   | Localized preferred label for the concept scheme. Keys are locale codes (e.g., 'en-US'), values are the labels in that locale.                                              |
| `definition`        | object  |          | `{"en-US":"A classification scheme for products"}` | Localized definition for the concept scheme. Keys are locale codes (e.g., 'en-US'), values are the definitions in that locale.                                              |
| `organization_id`   | string  |     ✅    | `"3STdL5T2FArlo1qttULwUR"`                         | The ID of the organization to create/update the concept scheme in                                                                                                           |
| `concept_scheme_id` | string  |     ✅    | `"test-scheme-composio-001"`                       | User-defined ID for the concept scheme. This will be used as the unique identifier for the concept scheme.                                                                  |

***

### `Contentful Update Space`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type    | Required | Example              | Description                                                                                                                                                                                                                                                                        |
| ---------- | ------- | :------: | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`     | string  |     ✅    | —                    | New name for the space                                                                                                                                                                                                                                                             |
| `version`  | integer |     ✅    | `1`                  | 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  |     ✅    | `"example_space_id"` | ID of the space to update                                                                                                                                                                                                                                                          |

***

### `Contentful Update Spaces Environments Tags`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                  | Description                                                                                              |
| ---------------------- | ------- | :------: | ------------------------ | -------------------------------------------------------------------------------------------------------- |
| `sys`                  | object  |     ✅    | —                        | System metadata for the tag (must include id and type fields)                                            |
| `name`                 | string  |     ✅    | `"Updated API Test Tag"` | Display name for the tag                                                                                 |
| `tag_id`               | string  |     ✅    | `"api-test-tag"`         | ID of the tag to update                                                                                  |
| `space_id`             | string  |     ✅    | `"oducbj6n3pdj"`         | ID of the space containing the tag                                                                       |
| `environment_id`       | string  |     ✅    | `"master"`               | ID of the environment containing the tag (typically 'master')                                            |
| `x_contentful_version` | integer |          | `1`                      | Version of the tag to update (used for optimistic locking). If not provided, the API will use version 1. |

***

### `Contentful Validate Bulk Action`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example          | Description                                                                          |
| ---------------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------------------ |
| `action`         | string |          | —                | Enum for bulk action types.                                                          |
| `entities`       | object |     ✅    | —                | Collection of entities (entries or assets) to validate for bulk action               |
| `space_id`       | string |     ✅    | `"oducbj6n3pdj"` | ID of the space containing the entries/assets to validate                            |
| `environment_id` | string |     ✅    | `"master"`       | ID of the environment containing the entries/assets to validate (typically 'master') |

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/contentful.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
