> ## Documentation Index > Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt > Use this file to discover all available pages before exploring further. # contentful > Contentful CMS **Server path:** `/contentful` | **Type:** Application | **PCID required:** Yes ## Tools | Tool | Description | | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`contentful_create_asset`](#contentful_create_asset) | Create a new asset with metadata. After creating, you can process and publish the asset separately. | | [`contentful_create_content_type`](#contentful_create_content_type) | Create a new content type. The content type must be published (activated) before entries can be created against it. | | [`contentful_create_entry`](#contentful_create_entry) | Create a new entry. Entries are created as drafts and must be published separately. Set the X-Contentful-Content-Type header to the content type ID. | | [`contentful_create_environment`](#contentful_create_environment) | Create a new environment in a space. The environment is cloned from the current master environment. | | [`contentful_create_locale`](#contentful_create_locale) | Create a new locale for multi-language content support | | [`contentful_create_or_update_tag`](#contentful_create_or_update_tag) | Create or update a tag. The tag ID is specified in the URL path. | | [`contentful_delete_asset`](#contentful_delete_asset) | Delete an asset. The asset must be unpublished first. | | [`contentful_delete_content_type`](#contentful_delete_content_type) | Delete a content type. The content type must be unpublished (deactivated) first and have no entries. | | [`contentful_delete_entry`](#contentful_delete_entry) | Delete an entry. The entry must be unpublished first. | | [`contentful_delete_environment`](#contentful_delete_environment) | Delete an environment. Cannot delete the master environment. | | [`contentful_delete_locale`](#contentful_delete_locale) | Delete a locale. This removes all content in this locale. | | [`contentful_delete_tag`](#contentful_delete_tag) | Delete a tag. Requires the current version for optimistic locking. | | [`contentful_get_asset`](#contentful_get_asset) | Get a specific asset with its metadata and file details | | [`contentful_get_content_type`](#contentful_get_content_type) | Get a specific content type with its field definitions | | [`contentful_get_entry`](#contentful_get_entry) | Get a specific entry with all its field values | | [`contentful_get_locale`](#contentful_get_locale) | Get details of a specific locale | | [`contentful_get_space`](#contentful_get_space) | Get details of a specific space | | [`contentful_list_assets`](#contentful_list_assets) | List all assets in a space and environment. Supports search and pagination. | | [`contentful_list_content_types`](#contentful_list_content_types) | List all content types in a space and environment | | [`contentful_list_environments`](#contentful_list_environments) | List all environments in a space | | [`contentful_list_locales`](#contentful_list_locales) | List all locales configured in an environment | | [`contentful_list_spaces`](#contentful_list_spaces) | List all spaces the authenticated user has access to | | [`contentful_list_tags`](#contentful_list_tags) | List all tags in an environment | | [`contentful_publish_asset`](#contentful_publish_asset) | Publish an asset to make it available via the Content Delivery API | | [`contentful_publish_content_type`](#contentful_publish_content_type) | Publish (activate) a content type so entries can be created against it | | [`contentful_publish_entry`](#contentful_publish_entry) | Publish an entry to make it available via the Content Delivery API | | [`contentful_search_entries`](#contentful_search_entries) | Search and filter entries. Supports content\_type, full-text search, field-based filters, ordering, and pagination. | | [`contentful_unpublish_asset`](#contentful_unpublish_asset) | Unpublish an asset to remove it from the Content Delivery API | | [`contentful_unpublish_content_type`](#contentful_unpublish_content_type) | Unpublish (deactivate) a content type. All entries of this type must be deleted first. | | [`contentful_unpublish_entry`](#contentful_unpublish_entry) | Unpublish an entry to remove it from the Content Delivery API | | [`contentful_update_asset`](#contentful_update_asset) | Update an asset's metadata. Requires the current version for optimistic locking. | | [`contentful_update_content_type`](#contentful_update_content_type) | Update a content type. You must send the complete content type body (not a partial update). Include the X-Contentful-Version header with the current version number. | | [`contentful_update_entry`](#contentful_update_entry) | Update an entry. You must send the complete fields object (not a partial update). Requires the current version for optimistic locking. | | [`contentful_update_locale`](#contentful_update_locale) | Update a locale's settings. Requires the current version. | *** ## contentful\_create\_asset Create a new asset with metadata. After creating, you can process and publish the asset separately. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `fields` | object | Yes | — | Asset fields with locale keys. Must include 'title' and 'file'. File field should have 'contentType', 'fileName', and either 'upload' (URL to fetch) or 'uploadFrom' (reference to an upload). Example: \{"title": \{"en-US": "My Image"}, "file": \{"en-US": \{"contentType": "image/png", "fileName": "image.png", "upload": "[https://example.com/image.png"\}\}\}](https://example.com/image.png"\}\}\}); | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "fields": { "type": "object", "description": "Asset fields with locale keys. Must include 'title' and 'file'. File field should have 'contentType', 'fileName', and either 'upload' (URL to fetch) or 'uploadFrom' (reference to an upload). Example: {\"title\": {\"en-US\": \"My Image\"}, \"file\": {\"en-US\": {\"contentType\": \"image/png\", \"fileName\": \"image.png\", \"upload\": \"https://example.com/image.png\"}}}" } }, "required": [ "PCID", "space_id", "environment_id", "fields" ] } ``` *** ## contentful\_create\_content\_type Create a new content type. The content type must be published (activated) before entries can be created against it. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `description` | string | No | — | Description of the content type | | `displayField` | string | No | — | ID of the field used as the display field for entries of this content type | | `fields` | object\[] | Yes | — | Array of field definitions. Each field has: id (string), name (string), type (string: Symbol, Text, Integer, Number, Date, Boolean, Object, Location, Array, Link, RichText), required (boolean), localized (boolean), and optional validations array. | | `name` | string | Yes | — | Name of the content type | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "description": { "type": "string", "description": "Description of the content type" }, "displayField": { "type": "string", "description": "ID of the field used as the display field for entries of this content type" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Field ID" }, "name": { "type": "string", "description": "Field display name" }, "type": { "type": "string", "description": "Field type: Symbol, Text, Integer, Number, Date, Boolean, Object, Location, Array, Link, RichText" }, "required": { "type": "boolean", "description": "Whether this field is required" }, "localized": { "type": "boolean", "description": "Whether this field supports localization" }, "validations": { "type": "array", "items": { "type": "object" }, "description": "Array of validation rules" }, "items": { "type": "object", "description": "For Array fields, defines the item type" }, "linkType": { "type": "string", "description": "For Link fields: Asset or Entry" } } }, "description": "Array of field definitions. Each field has: id (string), name (string), type (string: Symbol, Text, Integer, Number, Date, Boolean, Object, Location, Array, Link, RichText), required (boolean), localized (boolean), and optional validations array." }, "name": { "type": "string", "description": "Name of the content type" } }, "required": [ "PCID", "space_id", "environment_id", "fields", "name" ] } ``` *** ## contentful\_create\_entry Create a new entry. Entries are created as drafts and must be published separately. Set the X-Contentful-Content-Type header to the content type ID. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------ | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `content_type_id` | string | Yes | — | The content type ID for the new entry (sent as X-Contentful-Content-Type header) | | `fields` | object | Yes | — | Entry field values. Each field is keyed by field ID, with locale-keyed values. Example: \{"title": \{"en-US": "Hello World"}, "body": \{"en-US": "Content here"}} | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "content_type_id": { "type": "string", "description": "The content type ID for the new entry (sent as X-Contentful-Content-Type header)" }, "fields": { "type": "object", "description": "Entry field values. Each field is keyed by field ID, with locale-keyed values. Example: {\"title\": {\"en-US\": \"Hello World\"}, \"body\": {\"en-US\": \"Content here\"}}" } }, "required": [ "PCID", "space_id", "environment_id", "content_type_id", "fields" ] } ``` *** ## contentful\_create\_environment Create a new environment in a space. The environment is cloned from the current master environment. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------- | ------ | -------- | ------- | --------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `name` | string | Yes | — | Name of the new environment | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "name": { "type": "string", "description": "Name of the new environment" } }, "required": [ "PCID", "space_id", "name" ] } ``` *** ## contentful\_create\_locale Create a new locale for multi-language content support **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------ | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `code` | string | Yes | — | Locale code following IETF BCP 47 (e.g. 'en-US', 'de-DE') | | `contentDeliveryApi` | boolean | No | — | Whether this locale is available via the Content Delivery API (default true) | | `contentManagementApi` | boolean | No | — | Whether this locale is available via the Content Management API (default true) | | `fallbackCode` | string | No | — | Locale code to fall back to if content is missing in this locale | | `name` | string | Yes | — | Display name of the locale (e.g. 'English (United States)') | | `optional` | boolean | No | — | Whether content in this locale is optional (default false) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "code": { "type": "string", "description": "Locale code following IETF BCP 47 (e.g. 'en-US', 'de-DE')" }, "contentDeliveryApi": { "type": "boolean", "description": "Whether this locale is available via the Content Delivery API (default true)" }, "contentManagementApi": { "type": "boolean", "description": "Whether this locale is available via the Content Management API (default true)" }, "fallbackCode": { "type": "string", "description": "Locale code to fall back to if content is missing in this locale" }, "name": { "type": "string", "description": "Display name of the locale (e.g. 'English (United States)')" }, "optional": { "type": "boolean", "description": "Whether content in this locale is optional (default false)" } }, "required": [ "PCID", "space_id", "environment_id", "code", "name" ] } ``` *** ## contentful\_create\_or\_update\_tag Create or update a tag. The tag ID is specified in the URL path. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `tag_id` | string | Yes | — | The ID of the tag to create or update | | `version` | integer | No | — | Current version number of the tag for optimistic locking. Required when updating an existing tag — omit when creating a new tag. Get this from the sys.version field of the existing tag. | | `name` | string | Yes | — | Display name of the tag | | `sys` | object | No | — | System metadata. For updates, include the current version: \{"id": "tag\_id", "type": "Tag", "version": N} | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "tag_id": { "type": "string", "description": "The ID of the tag to create or update" }, "version": { "type": "integer", "description": "Current version number of the tag for optimistic locking. Required when updating an existing tag — omit when creating a new tag. Get this from the sys.version field of the existing tag." }, "name": { "type": "string", "description": "Display name of the tag" }, "sys": { "type": "object", "description": "System metadata. For updates, include the current version: {\"id\": \"tag_id\", \"type\": \"Tag\", \"version\": N}", "properties": { "id": { "type": "string", "description": "The id value" }, "type": { "type": "string", "description": "The type value", "enum": [ "Tag" ] }, "version": { "type": "integer", "description": "The version value" }, "visibility": { "type": "string", "description": "The visibility value", "enum": [ "public", "private" ] } } } }, "required": [ "PCID", "space_id", "environment_id", "tag_id", "name" ] } ``` *** ## contentful\_delete\_asset Delete an asset. The asset must be unpublished first. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ----------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `asset_id` | string | Yes | — | The ID of the asset to delete | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "asset_id": { "type": "string", "description": "The ID of the asset to delete" } }, "required": [ "PCID", "space_id", "environment_id", "asset_id" ] } ``` *** ## contentful\_delete\_content\_type Delete a content type. The content type must be unpublished (deactivated) first and have no entries. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------ | -------- | ------- | ------------------------------------ | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `content_type_id` | string | Yes | — | The ID of the content type to delete | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "content_type_id": { "type": "string", "description": "The ID of the content type to delete" } }, "required": [ "PCID", "space_id", "environment_id", "content_type_id" ] } ``` *** ## contentful\_delete\_entry Delete an entry. The entry must be unpublished first. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ----------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `entry_id` | string | Yes | — | The ID of the entry to delete | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "entry_id": { "type": "string", "description": "The ID of the entry to delete" } }, "required": [ "PCID", "space_id", "environment_id", "entry_id" ] } ``` *** ## contentful\_delete\_environment Delete an environment. Cannot delete the master environment. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ----------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment to delete | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment to delete" } }, "required": [ "PCID", "space_id", "environment_id" ] } ``` *** ## contentful\_delete\_locale Delete a locale. This removes all content in this locale. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ------------------------------ | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `locale_id` | string | Yes | — | The ID of the locale to delete | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "locale_id": { "type": "string", "description": "The ID of the locale to delete" } }, "required": [ "PCID", "space_id", "environment_id", "locale_id" ] } ``` *** ## contentful\_delete\_tag Delete a tag. Requires the current version for optimistic locking. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `tag_id` | string | Yes | — | The ID of the tag to delete | | `version` | integer | Yes | — | Current version number of the tag (for X-Contentful-Version header) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "tag_id": { "type": "string", "description": "The ID of the tag to delete" }, "version": { "type": "integer", "description": "Current version number of the tag (for X-Contentful-Version header)" } }, "required": [ "PCID", "space_id", "environment_id", "tag_id", "version" ] } ``` *** ## contentful\_get\_asset Get a specific asset with its metadata and file details **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `asset_id` | string | Yes | — | The ID of the asset | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "asset_id": { "type": "string", "description": "The ID of the asset" } }, "required": [ "PCID", "space_id", "environment_id", "asset_id" ] } ``` *** ## contentful\_get\_content\_type Get a specific content type with its field definitions **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------ | -------- | ------- | -------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `content_type_id` | string | Yes | — | The ID of the content type | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "content_type_id": { "type": "string", "description": "The ID of the content type" } }, "required": [ "PCID", "space_id", "environment_id", "content_type_id" ] } ``` *** ## contentful\_get\_entry Get a specific entry with all its field values **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `entry_id` | string | Yes | — | The ID of the entry | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "entry_id": { "type": "string", "description": "The ID of the entry" } }, "required": [ "PCID", "space_id", "environment_id", "entry_id" ] } ``` *** ## contentful\_get\_locale Get details of a specific locale **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `locale_id` | string | Yes | — | The ID of the locale | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "locale_id": { "type": "string", "description": "The ID of the locale" } }, "required": [ "PCID", "space_id", "environment_id", "locale_id" ] } ``` *** ## contentful\_get\_space Get details of a specific space **Parameters:** | Parameter | Type | Required | Default | Description | | ---------- | ------ | -------- | ------- | ------------------- | | `space_id` | string | Yes | — | The ID of the space | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" } }, "required": [ "PCID", "space_id" ] } ``` *** ## contentful\_list\_assets List all assets in a space and environment. Supports search and pagination. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ----------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `mimetype_group` | string | No | — | Filter by MIME type group | | `query` | string | No | — | Full-text search query | | `limit` | integer | No | — | Maximum number of assets to return (max 1000) | | `skip` | integer | No | — | Number of assets to skip for pagination | | `order` | string | No | — | Field to order by, prefix with - for descending | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "mimetype_group": { "type": "string", "description": "Filter by MIME type group", "enum": [ "attachment", "plaintext", "image", "audio", "video", "richtext", "presentation", "spreadsheet", "pdfdocument", "archive", "code", "markup" ] }, "query": { "type": "string", "description": "Full-text search query" }, "limit": { "type": "integer", "description": "Maximum number of assets to return (max 1000)" }, "skip": { "type": "integer", "description": "Number of assets to skip for pagination" }, "order": { "type": "string", "description": "Field to order by, prefix with - for descending" } }, "required": [ "PCID", "space_id", "environment_id" ] } ``` *** ## contentful\_list\_content\_types List all content types in a space and environment **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ---------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment (e.g. 'master') | | `limit` | integer | No | — | Maximum number of content types to return (max 1000) | | `skip` | integer | No | — | Number of content types to skip for pagination | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment (e.g. 'master')" }, "limit": { "type": "integer", "description": "Maximum number of content types to return (max 1000)" }, "skip": { "type": "integer", "description": "Number of content types to skip for pagination" } }, "required": [ "PCID", "space_id", "environment_id" ] } ``` *** ## contentful\_list\_environments List all environments in a space **Parameters:** | Parameter | Type | Required | Default | Description | | ---------- | ------- | -------- | ------- | --------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `limit` | integer | No | — | Maximum number of environments to return | | `skip` | integer | No | — | Number of environments to skip for pagination | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "limit": { "type": "integer", "description": "Maximum number of environments to return" }, "skip": { "type": "integer", "description": "Number of environments to skip for pagination" } }, "required": [ "PCID", "space_id" ] } ``` *** ## contentful\_list\_locales List all locales configured in an environment **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | ------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" } }, "required": [ "PCID", "space_id", "environment_id" ] } ``` *** ## contentful\_list\_spaces List all spaces the authenticated user has access to **Parameters:** | Parameter | Type | Required | Default | Description | | --------- | ------- | -------- | ------- | -------------------------------------------- | | `limit` | integer | No | — | Maximum number of spaces to return (max 100) | | `skip` | integer | No | — | Number of spaces to skip for pagination | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "limit": { "type": "integer", "description": "Maximum number of spaces to return (max 100)" }, "skip": { "type": "integer", "description": "Number of spaces to skip for pagination" } }, "required": [ "PCID" ] } ``` *** ## contentful\_list\_tags List all tags in an environment **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `limit` | integer | No | — | Maximum number of tags to return | | `skip` | integer | No | — | Number of tags to skip for pagination | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "limit": { "type": "integer", "description": "Maximum number of tags to return" }, "skip": { "type": "integer", "description": "Number of tags to skip for pagination" } }, "required": [ "PCID", "space_id", "environment_id" ] } ``` *** ## contentful\_publish\_asset Publish an asset to make it available via the Content Delivery API **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | --------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `asset_id` | string | Yes | — | The ID of the asset to publish | | `version` | integer | Yes | — | Current version number of the asset (for X-Contentful-Version header) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "asset_id": { "type": "string", "description": "The ID of the asset to publish" }, "version": { "type": "integer", "description": "Current version number of the asset (for X-Contentful-Version header)" } }, "required": [ "PCID", "space_id", "environment_id", "asset_id", "version" ] } ``` *** ## contentful\_publish\_content\_type Publish (activate) a content type so entries can be created against it **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `content_type_id` | string | Yes | — | The ID of the content type to publish | | `version` | integer | Yes | — | Current version number of the content type (for X-Contentful-Version header) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "content_type_id": { "type": "string", "description": "The ID of the content type to publish" }, "version": { "type": "integer", "description": "Current version number of the content type (for X-Contentful-Version header)" } }, "required": [ "PCID", "space_id", "environment_id", "content_type_id", "version" ] } ``` *** ## contentful\_publish\_entry Publish an entry to make it available via the Content Delivery API **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | --------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `entry_id` | string | Yes | — | The ID of the entry to publish | | `version` | integer | Yes | — | Current version number of the entry (for X-Contentful-Version header) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "entry_id": { "type": "string", "description": "The ID of the entry to publish" }, "version": { "type": "integer", "description": "Current version number of the entry (for X-Contentful-Version header)" } }, "required": [ "PCID", "space_id", "environment_id", "entry_id", "version" ] } ``` *** ## contentful\_search\_entries Search and filter entries. Supports content\_type, full-text search, field-based filters, ordering, and pagination. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `content_type` | string | No | — | Filter by content type ID. Required when using field-based filters. | | `query` | string | No | — | Full-text search query across all text and symbol fields | | `select` | string | No | — | Comma-separated list of fields to include in response (e.g. 'sys.id,fields.title') | | `order` | string | No | — | Field to order by, prefix with - for descending (e.g. '-sys.createdAt') | | `limit` | integer | No | — | Maximum number of entries to return (max 1000) | | `skip` | integer | No | — | Number of entries to skip for pagination | | `include` | integer | No | — | Number of levels of linked entries/assets to resolve (0-10, default 1) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "content_type": { "type": "string", "description": "Filter by content type ID. Required when using field-based filters." }, "query": { "type": "string", "description": "Full-text search query across all text and symbol fields" }, "select": { "type": "string", "description": "Comma-separated list of fields to include in response (e.g. 'sys.id,fields.title')" }, "order": { "type": "string", "description": "Field to order by, prefix with - for descending (e.g. '-sys.createdAt')" }, "limit": { "type": "integer", "description": "Maximum number of entries to return (max 1000)" }, "skip": { "type": "integer", "description": "Number of entries to skip for pagination" }, "include": { "type": "integer", "description": "Number of levels of linked entries/assets to resolve (0-10, default 1)" } }, "required": [ "PCID", "space_id", "environment_id" ] } ``` *** ## contentful\_unpublish\_asset Unpublish an asset to remove it from the Content Delivery API **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | -------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `asset_id` | string | Yes | — | The ID of the asset to unpublish | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "asset_id": { "type": "string", "description": "The ID of the asset to unpublish" } }, "required": [ "PCID", "space_id", "environment_id", "asset_id" ] } ``` *** ## contentful\_unpublish\_content\_type Unpublish (deactivate) a content type. All entries of this type must be deleted first. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | ------ | -------- | ------- | --------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `content_type_id` | string | Yes | — | The ID of the content type to unpublish | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "content_type_id": { "type": "string", "description": "The ID of the content type to unpublish" } }, "required": [ "PCID", "space_id", "environment_id", "content_type_id" ] } ``` *** ## contentful\_unpublish\_entry Unpublish an entry to remove it from the Content Delivery API **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------ | -------- | ------- | -------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `entry_id` | string | Yes | — | The ID of the entry to unpublish | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "entry_id": { "type": "string", "description": "The ID of the entry to unpublish" } }, "required": [ "PCID", "space_id", "environment_id", "entry_id" ] } ``` *** ## contentful\_update\_asset Update an asset's metadata. Requires the current version for optimistic locking. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `asset_id` | string | Yes | — | The ID of the asset to update | | `version` | integer | Yes | — | Current version number of the asset (for X-Contentful-Version header) | | `fields` | object | Yes | — | Complete asset fields with locale keys including title, description, and file | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "asset_id": { "type": "string", "description": "The ID of the asset to update" }, "version": { "type": "integer", "description": "Current version number of the asset (for X-Contentful-Version header)" }, "fields": { "type": "object", "description": "Complete asset fields with locale keys including title, description, and file" } }, "required": [ "PCID", "space_id", "environment_id", "asset_id", "version", "fields" ] } ``` *** ## contentful\_update\_content\_type Update a content type. You must send the complete content type body (not a partial update). Include the X-Contentful-Version header with the current version number. **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `content_type_id` | string | Yes | — | The ID of the content type to update | | `version` | integer | Yes | — | Current version number of the content type (used for optimistic locking via X-Contentful-Version header). Get this from the sys.version field of the content type. | | `description` | string | No | — | Description of the content type | | `displayField` | string | No | — | ID of the field used as the display field | | `fields` | object\[] | No | — | Complete array of field definitions (replaces existing fields) | | `name` | string | No | — | Name of the content type | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "content_type_id": { "type": "string", "description": "The ID of the content type to update" }, "version": { "type": "integer", "description": "Current version number of the content type (used for optimistic locking via X-Contentful-Version header). Get this from the sys.version field of the content type." }, "description": { "type": "string", "description": "Description of the content type" }, "displayField": { "type": "string", "description": "ID of the field used as the display field" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The id value" }, "name": { "type": "string", "description": "The name value" }, "type": { "type": "string", "description": "The type value" }, "required": { "type": "boolean", "description": "The required value" }, "localized": { "type": "boolean", "description": "The localized value" }, "validations": { "type": "array", "items": { "type": "object" }, "description": "The validations value" }, "items": { "type": "object", "description": "The items value" }, "linkType": { "type": "string", "description": "Link Type" } } }, "description": "Complete array of field definitions (replaces existing fields)" }, "name": { "type": "string", "description": "Name of the content type" } }, "required": [ "PCID", "space_id", "environment_id", "content_type_id", "version" ] } ``` *** ## contentful\_update\_entry Update an entry. You must send the complete fields object (not a partial update). Requires the current version for optimistic locking. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `entry_id` | string | Yes | — | The ID of the entry to update | | `version` | integer | Yes | — | Current version number of the entry (for X-Contentful-Version header). Get from sys.version. | | `fields` | object | Yes | — | Complete entry field values with locale keys. Example: \{"title": \{"en-US": "Updated Title"}} | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "entry_id": { "type": "string", "description": "The ID of the entry to update" }, "version": { "type": "integer", "description": "Current version number of the entry (for X-Contentful-Version header). Get from sys.version." }, "fields": { "type": "object", "description": "Complete entry field values with locale keys. Example: {\"title\": {\"en-US\": \"Updated Title\"}}" } }, "required": [ "PCID", "space_id", "environment_id", "entry_id", "version", "fields" ] } ``` *** ## contentful\_update\_locale Update a locale's settings. Requires the current version. **Parameters:** | Parameter | Type | Required | Default | Description | | ---------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------- | | `space_id` | string | Yes | — | The ID of the space | | `environment_id` | string | Yes | — | The ID of the environment | | `locale_id` | string | Yes | — | The ID of the locale to update | | `version` | integer | Yes | — | Current version number of the locale (for X-Contentful-Version header) | | `code` | string | No | — | Locale code (IETF BCP 47) | | `contentDeliveryApi` | boolean | No | — | Whether available via CDA | | `contentManagementApi` | boolean | No | — | Whether available via CMA | | `fallbackCode` | string | No | — | Fallback locale code | | `name` | string | No | — | Display name of the locale | | `optional` | boolean | No | — | Whether content is optional for this locale | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "space_id": { "type": "string", "description": "The ID of the space" }, "environment_id": { "type": "string", "description": "The ID of the environment" }, "locale_id": { "type": "string", "description": "The ID of the locale to update" }, "version": { "type": "integer", "description": "Current version number of the locale (for X-Contentful-Version header)" }, "code": { "type": "string", "description": "Locale code (IETF BCP 47)" }, "contentDeliveryApi": { "type": "boolean", "description": "Whether available via CDA" }, "contentManagementApi": { "type": "boolean", "description": "Whether available via CMA" }, "fallbackCode": { "type": "string", "description": "Fallback locale code" }, "name": { "type": "string", "description": "Display name of the locale" }, "optional": { "type": "boolean", "description": "Whether content is optional for this locale" } }, "required": [ "PCID", "space_id", "environment_id", "locale_id", "version" ] } ```