withoneai 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
- Find the action in the table below, or call
search_one_platform_actionswith platformcontentful-content-managementif it is not listed. - Call
get_one_action_knowledgewith the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters. - Call
execute_one_actionwith 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 |
conn_mod_def::GLU3QlnmNwA::JZlNic9qSXeNZUKN-0YHKw |
| Add or Update a ResourceLink Field on an Entry | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/entries/{{entryId}} |
conn_mod_def::GLU3P8ArWag::2nHBBMrrS5WuBFmEpmytKg |
| Archive an Entry in a Space Environment | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/entries/{{entryId}}/archived |
conn_mod_def::GLU3QWf-ohA::kmC-j4fDSkias2bALXmbZw |
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}} |
conn_mod_def::GLU3YgG9npA::GzJ-FXj6QIC1Tg8jAEH8xQ |
| Publish a Release in a Space Environment | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}/published |
conn_mod_def::GLU3T7jdPLA::TLZ3mtc9T42Nnc9VfbvcyQ |
| Publish a Release in a Space Environment | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}/published |
conn_mod_def::GLU3YgOmtZg::RaxjgU5gSSCn3p-dwNNZIw |
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 |
conn_mod_def::GLU3NP4Bdng::6bKH4ayIT4CQF9xh75VNxA |
| Process an Asset File Locale in a Release | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/releases/{{releaseId}}/assets/{{assetId}}/files/{{localeCode}}/process |
conn_mod_def::GLU3X83f7wg::PVUNZl2KRhi7vSmgBk6_5g |
| Publish an Asset in a Space Environment | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/assets/{{assetId}}/published |
conn_mod_def::GLU3NbP1qbg::4EHOG_SlTNivDosFmUkYqA |
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 |
| Update a Content Type in a Space Environment | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}} |
conn_mod_def::GLU3Pwt_kKA::ysg5ufnXR6maseDdLNOM6A |
| Update a Content Type in a Space Environment | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}} |
conn_mod_def::GLU3Px7vA3g::qX7X7tQkS0CSRsnnEGkTfA |
| Update a Content Type in a Space Environment | PUT | /spaces/{{spaceId}}/environments/{{environmentId}}/content_types/{{contentTypeId}} |
conn_mod_def::GLU3WnlncdA::5eBsTY0gS2i_01ov9z1DJQ |
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.