contentful-content-management

name

contentful-content-management

description

Contentful is a headless content management platform that provides APIs for modeling, managing, and delivering structured content across websites, apps, and digital experiences, allowing developers and content teams to build omnichannel publishing workflows and integrate content into custom applications. Read and write Contentful Content Management data through One: entries, releases, assets, contenttypes, aiactions, aiproviders and more, 371 actions with real parameter documentation. Use whenever the user asks to look something up in Contentful Content Management, create or update a record there, or build code against the Contentful Content Management API.

Contentful Content Management through One

Contentful is a headless content management platform that provides APIs for modeling, managing, and delivering structured content across websites, apps, and digital experiences, allowing developers and content teams to build omnichannel publishing workflows and integrate content into custom applications.

One exposes Contentful Content Management through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform contentful-content-management if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Contentful Content Management is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Contentful Content Management account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Entries

Action	Method	Path	Action id
Get an Entry in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries/{{entryId}}	conn_mod_def::GLU3Qk-AgJA::GxxmB08jSGi0M9WVQj8aIQ
List Entries by Metadata Concept in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries	conn_mod_def::GLU3Xndr61A::z4PjX6RwTe2lrZ3huugDUQ
List Entries for a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries	conn_mod_def::GLU3XeBhSxA::jXYxSQzrSP6UAqyA5N_gbg
List Entries for a Space Environment by Metadata Tag	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries	conn_mod_def::GLU3WmW-0kA::OlmFIaG4R02aq0SAbQScAw
List Entries in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries	conn_mod_def::GLU3QkFONag::yDT0tbI-TUqu88x0NljOUQ
List Entries in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries	conn_mod_def::GLU3XpzLAxg::PT-qbBNARp2MnLFSZ3IOKA
List Entries in a Space Environment by Metadata Tag	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries	conn_mod_def::GLU3WneegUA::hwV3bpbQSCylr2RKd9K2XQ
List Entries in a Space Environment by Metadata Tag Existence	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries	conn_mod_def::GLU3WSnSmcA::FMsjoEafT_Wn4MyK3hTCVA
List Entries Using Contentful Spaces Environments	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries	conn_mod_def::GLU3U-jpX-g::DaiJbhffRYyFqllLmAM49w
References for an Entry in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/entries/{{entryId}}/references

16 more Entries actions are available through search.

Releases

Action	Method	Path	Action id
Get a Release in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}	conn_mod_def::GLU3Tw-EDqA::GpdWwYy3RG-Ns1PAF8JYNg
Get a Release in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}	conn_mod_def::GLU3YTKrhKA::DI2aVDouR0yO8xBCNpGyFw
List Releases for a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/releases	conn_mod_def::GLU3YgyNvzA::2VjcUIKRS8-aPtC2IEJ6Hw
List Releases in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/	conn_mod_def::GLU3UFLR-Ng::U1Caj6gxRQuA3VwxC1CSwA
Archive a Release in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}/archived	conn_mod_def::GLU3Tls4xLg::Vjt5VoH2Tx6Ms_Bx60EW8g
Archive a Release in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}/archived	conn_mod_def::GLU3YUr8AWA::PBf00nKVTKube22J_zICvg
Create Releases for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/	conn_mod_def::GLU3Tyw5cAg::a71QtVTIT66WWVMMuEHDyg
Create Releases for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/releases	conn_mod_def::GLU3YXBf2AA::K8II8kzyTUGp6q7JbjS8YA
Delete a Release in a Space Environment	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}	conn_mod_def::GLU3UFK0EJg::Tu5sob-PSFiLkikqKsiDpw
Delete a Release in a Space Environment	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}

6 more Releases actions are available through search.

Assets

Action	Method	Path	Action id
Get an Environment Asset	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/assets/{{assetId}}	conn_mod_def::GLU3NPAoSBA::6d7cWi-yRgq1Hdapc5d45g
List Assets in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/assets	conn_mod_def::GLU3NODsk9g::vt-Mi6JSSjGZxx56PaGBLw
Archive an Asset in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/assets/{{assetId}}/archived	conn_mod_def::GLU3MxGowJg::sMGPWA90QZ-O09WDOjWvvg
Archive an Asset in a Space Environment	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}/assets/{{assetId}}/archived	conn_mod_def::GLU3Nc4hehA::3oRJ5ccPR4qo-jh11ttwjQ
Create an Asset for a Release	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}/assets	conn_mod_def::GLU3X9bzX9A::P5gPF-7qQEi1MigfQdAEJw
Create an Asset for a Release Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}/assets/{{assetId}}	conn_mod_def::GLU3X8eHXGg::3ABAx4XVTgOInuyXCNwk-w
Create an Asset in a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/assets	conn_mod_def::GLU3MxieDFA::JIjYmbamT8OxFuP78DKWfA
Create an Asset in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/assets/{{assetId}}	conn_mod_def::GLU3NFOCM0A::MGs49fzeT6ajokvPvaAxBQ
Delete an Asset in a Space Environment	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}/assets/{{assetId}}	conn_mod_def::GLU3NQTfx2A::J41vTFu_TDCpQKXSUWmWBg
Process an Asset File for a Locale in a Contentful Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/assets/{{assetId}}/files/{{localeCode}}/process

5 more Assets actions are available through search.

ContentTypes

Action	Method	Path	Action id
Get a Content Type for a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}}	conn_mod_def::GLU3Pj77Grg::ZsFUtzYUS9CZsoNkN-jQPQ
List Content Types for a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types	conn_mod_def::GLU3Ph4Se5g::6jbB2Fb4QQCzvWBf1PPz5w
Create a Content Type for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types	conn_mod_def::GLU3PWzXtaA::oTX8lQSnQeKvu6isQnITPg
Create a Content Type for a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}}	conn_mod_def::GLU3PYZBwIA::t4NUuJj_T8Cdz9tEJk_gpA
Create a Content Type in a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types	conn_mod_def::GLU3Pu4JSGg::9aTqqA9wSDW610LG11NcdQ
Delete a Content Type in a Space Environment	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}}	conn_mod_def::GLU3Ph3ML4A::nazgIT3NR2OEM_zQB4fBfQ
Publish a Content Type in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}}/published	conn_mod_def::GLU3PWwDoKg::Z2vL7BAWTGivaNKfLB0N1A
Unpublish a Content Type in a Space Environment	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}}/published	conn_mod_def::GLU3PkXMdzg::1vMISNseSZe67kHzWaK0Hw
Update a Content Type in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}}	conn_mod_def::GLU3PwaX61A::jM1EwtewTCarKRYpJgbS1g

3 more ContentTypes actions are available through search.

AiActions

Action	Method	Path	Action id
Get an AI Action in a Space	GET	/spaces/{{spaceId}}/ai/actions/{{aiActionId}}	conn_mod_def::GLU3JuWDVrA::MkKBctZHR1ysb2AdFfKsYg
List AI Actions for a Space	GET	/spaces/{{spaceId}}/ai/actions	conn_mod_def::GLU3Jaa0gEA::JqKBmBqoR26X8o-AjfdJDA
List AI Actions for a Space	GET	/spaces/{{spaceId}}/ai/actions	conn_mod_def::GLU3JuDwDwg::IiLjHajNSVawjKMOapLU2w
Create an AI Action for a Space	POST	/spaces/{{spaceId}}/ai/actions	conn_mod_def::GLU3JcydTfA::_osDJvlISoKSdjwBJr-JOg
Delete a Published AI Action in a Space Environment	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}/ai/actions/{{aiActionId}}/published	conn_mod_def::GLU3Js0_NgA::NUCckxEMSgq9--nUVyuInQ
Delete an AI Action in a Space	DELETE	/spaces/{{spaceId}}/ai/actions/{{aiActionId}}	conn_mod_def::GLU3JbrO4Og::N9_7MG6RQbOUbkw2H8_jQw
Publish an AI Action in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/ai/actions/{{aiActionId}}/published	conn_mod_def::GLU3Jt9tjbg::OPniwnw2Ruyueb3zEmpzbA
Update a Space AI Action	PUT	/spaces/{{spaceId}}/ai/actions/{{aiActionId}}	conn_mod_def::GLU3JviTTDg::coHk-zCxS7qdcgIiokcYGg

AiProviders

Action	Method	Path	Action id
Get an AI Provider for an Organization	GET	/organizations/{{organizationId}}/ai/providers/{{providerId}}	conn_mod_def::GLU3KE9gEpg::Zc4VLapWQnSb5_vU-OxXyg
List an Organization's AI Providers	GET	/organizations/{{organizationId}}/ai/providers	conn_mod_def::GLU3KEkqdTA::mCnbxLzpTIaYn-Uq4crgeA
Create an AI Provider for an Organization	POST	/organizations/{{organizationId}}/ai/providers	conn_mod_def::GLU3J42uHrA::8G6w6xhDSJ2jdqYDJpz-lA
Create an AI Provider for an Organization	POST	/organizations/{{organizationId}}/ai/providers	conn_mod_def::GLU3J5QE_7g::fAneizJgQCyFL8wCYeLn9w
Create an AI Provider for an Organization	POST	/organizations/{{organizationId}}/ai/providers	conn_mod_def::GLU3J5R3HpA::QXVmq6lhS36MR3IfgA33KA
Create an AI Provider for an Organization	POST	/organizations/{{organizationId}}/ai/providers	conn_mod_def::GLU3J5Y9U-g::T43j9V6QQ9q-YE6X43gnEg
Create an AI Provider for an Organization	POST	/organizations/{{organizationId}}/ai/providers	conn_mod_def::GLU3J71vBOg::XNEb_HMRTB257--BOx7AAA
Delete an AI Provider for an Organization	DELETE	/organizations/{{organizationId}}/ai/providers/{{providerId}}	conn_mod_def::GLU3KEw4gFA::1L_7OkHzSdOZeXR_E6FAnw

Environments

Action	Method	Path	Action id
Get an Environment in a Space	GET	/spaces/{{spaceId}}/environments/{{environmentId}}	conn_mod_def::GLU3R7PnzZA::xSonOTZVSim_PyLxMsjoBQ
List Environments for a Space	GET	/spaces/{{spaceId}}/environments	conn_mod_def::GLU3SKfaFwA::XLCm3sxlRQOIWTwagZ7U0A
Create an Environment in a Space	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}	conn_mod_def::GLU3RwszmeA::cxJsClD-SI2_cAzK-Ezgdg
Create an Environment in a Space	POST	/spaces/{{spaceId}}/environments	conn_mod_def::GLU3Rwt5_Wg::tFtITdhVSD21zNb_3oJ4fQ
Create an Environment in a Space	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}	conn_mod_def::GLU3RwyCvsA::8a62rZi_RgiVQbZPJivrqA
Create an Environment in a Space	POST	/spaces/{{spaceId}}/environments	conn_mod_def::GLU3RymXP7g::dvaVWtwoRnSAevsSS9LR_w
Delete an Environment in a Space	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}	conn_mod_def::GLU3R6zz7SA::YNL0wGfITlG58gjlCp4rHg
Update an Environment in a Space	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}	conn_mod_def::GLU3SFSykYg::H26XUEjUTn2bIUsF6TKWiw

BulkActions

Action	Method	Path	Action id
Get a Bulk Action in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/bulk_actions/actions/{{bulkActionId}}	conn_mod_def::GLU3ONv3l8A::3uHU-NPKRhWbFDJFfiYKRQ
Bulk Actions for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/bulk_actions	conn_mod_def::GLU3OOMpBgA::fEkxZ2TuQ56nROyHSVXjrw
Bulk Actions for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/bulk_actions	conn_mod_def::GLU3OagwmUA::d0xVd-MBRjmS3B38ppZyhQ
Create Bulk Actions for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/bulk_actions	conn_mod_def::GLU3OYFKrrA::1S4mVppLSVKnuQubU-4Jiw
Publish Bulk Actions for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/bulk_actions/publish	conn_mod_def::GLU3OXsZN8g::08o_y3UGQtqOx-C18c_Dzw
Unpublish Entities in a Contentful Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/bulk_actions/unpublish	conn_mod_def::GLU3OXzN9Hg::Mrs26LMVSyuijGQ4FTmKdw
Validate Bulk Actions for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/bulk_actions/validate	conn_mod_def::GLU3OYdlnBA::le6j-WONTC-DAfWcWIEmOg

WorkflowDefinitions

Action	Method	Path	Action id
Get a Workflow Definition for an Environment in a Space	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/workflow_definitions/{{workflowDefinitionId}}	conn_mod_def::GLU3aVDXSFg::RQPWKhZwSHWM0oRWe6x9Bg
List Workflow Definitions for an Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/workflow_definitions	conn_mod_def::GLU3aV2AoYA::a2vbH4aZRai2kFu0buwxTw
Create Workflow Definitions for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/workflow_definitions	conn_mod_def::GLU3SjccEOg::fzQk3N8CR-C9Nf4s0_DAoA
Create Workflow Definitions for a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/workflow_definitions	conn_mod_def::GLU3aKzniig::EzUZ5D9qSZmOs6cVnt5SaA
Delete a Workflow Definition for a Space Environment	DELETE	/spaces/{{spaceId}}/environments/{{environmentId}}/workflow_definitions/{{workflowDefinitionId}}	conn_mod_def::GLU3aUxUTJA::yK5uinzQTC2Dbu39ecG1pQ
Update a Workflow Definition for a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/workflow_definitions/{{workflowDefinitionId}}	conn_mod_def::GLU3aXJvC2g::VP423OZATq6cVNufqkKbBw
Update a Workflow Definition in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/workflow_definitions/{{workflowDefinitionId}}	conn_mod_def::GLU3SvnvT2g::sgq1IUKiR7mCWoEul3zsTQ

Workflows

Action	Method	Path	Action id
Get a Workflow in a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/workflows/{{workflowId}}	conn_mod_def::GLU3af7a83g::DicZCzA3R0SXkGUHtSTMNg
List Workflows for a Space Environment	GET	/spaces/{{spaceId}}/environments/{{environmentId}}/workflows	conn_mod_def::GLU3agtRKsg::trVLyCMbQEe49KtDEsZQug
Complete a Workflow in a Space Environment	PUT	/spaces/{{spaceId}}/environments/{{environmentId}}/workflows/{{workflowId}}/completed	conn_mod_def::GLU3ahQZx1A::iD7vvn77THCho5IuSWt4Og
Create a Workflow in a Space Environment	POST	/spaces/{{spaceId}}/environments/{{environmentId}}/workflows	conn_mod_def::GLU3aiIp_5A::fABPNiizTWm1JC-TWwfyMw

3 more Workflows actions are available through search.

This lists 90 of 371 actions. For anything not here, call search_one_platform_actions with platform contentful-content-management. The full catalog is at https://www.withone.ai/knowledge/contentful-content-management.

When a call fails

The error comes from Contentful Content Management, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/contentful-content-management

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.