withoneai Contentstack Content Management through One
Contentstack’s Content Management API is a powerful, API-first REST interface that enables developers to programmatically create, update, delete, and structure content—supporting secure token-based access, customizable content types, and flexible workflows for managing headless CMS operations across cloud-native environments.
One exposes Contentstack 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 platformcontentstack-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 Contentstack 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 Contentstack 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
Assets
| Action | Method | Path | Action id |
|---|---|---|---|
| Download an Asset with Permanent URL (by API Key, Asset UID, and Slug) | GET | /v3/assets/{{apiKey}}/{{assetUid}}/{{slug}} |
conn_mod_def::GJ1W86QMzcY::e0QvP3JdR6S9ht8hkkvPXA |
| Get All Versions of an Asset | GET | /v3/assets/{{assetUid}}/versions |
conn_mod_def::GJ1W9vCM4Yk::ckkZ4uEGTj6g-FbLNKa1pA |
| Get an Asset (by Asset UID) | GET | /v3/assets/{{assetUid}} |
conn_mod_def::GJ1W9a2DLDw::Ndbkz6KhSM2WK-zNu2iZZw |
| Get Asset References | GET | /v3/assets/{{assetUid}}/references |
conn_mod_def::GJ1W9lGgX2E::Axx7vJXyT9OVKOAKX6xTYg |
| Get Either Only Images or Videos (Assets by Type) | GET | /v3/assets/{{assetType}} |
conn_mod_def::GJ1W95hn4Ho::M-wxobwsQxKTz-vzhehGew |
| List Assets (Optionally Filter by Folder / Include Subfolders) | GET | /assets |
conn_mod_def::GJ1W9PDmv9E::pJqXf-CTR7u4cjfFrgLZCw |
| Delete an Asset | DELETE | /v3/assets/{{assetUid}} |
conn_mod_def::GJ1W8mvTzCo::uHzPJnhhQRCru_RBpquRNQ |
| Delete an Asset Version’s Name | DELETE | /v3/assets/{{assetUid}}/versions/{{versionNumber}}/name |
conn_mod_def::GJ1W8wExQA4::2DW-glsjQ6i8R1zRMB1IKQ |
| Publish an Asset | POST | /v3/assets/{{assetUid}}/publish |
conn_mod_def::GJ1W-MPhgUY::Ql9XXbyLQrKBK09df5DbJA |
| Replace an Asset (Update a Specific Asset) | PUT | /v3/assets/{{assetUid}} |
conn_mod_def::GJ1W-Y3IPqM::uQDpTullTlGq8B5CJhAbvA |
| Set a Version Name for an Asset | POST | /v3/assets/{{assetUid}}/versions/{{versionNumber}}/name |
conn_mod_def::GJ1W-kqbTSw::Z3ia95tRQ_ezJqF9CeG0oQ |
| Unpublish an Asset | POST | /v3/assets/{{assetUid}}/unpublish |
conn_mod_def::GJ1W-tO4wr4::4q7dtXR_SZ2ZLwCv4Mrp5g |
1 more Assets actions are available through search.
Extensions
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Single Asset Sidebar Extension | GET | /v3/extensions/{{assetSidebarExtensionUid}} |
conn_mod_def::GJ1XIIF2pc0::nFSH11YkR3mts2FfLHUelw |
| Get a Single Custom Field (Extension) | GET | /v3/extensions/{{customFieldUid}} |
conn_mod_def::GJ1XIV2GLm4::uxur45jiQoiGR3ZtBs0LVg |
| Get a Single JSON RTE Plugin | GET | /v3/extensions/{{jsonRtePluginUid}} |
conn_mod_def::GJ1XIgOfCn4::LF3hnFtdQ3yo6yAdS45pCg |
| List Stack Extensions (Custom Fields, Widgets, Dashboard Widgets, JSON RTE Plugins) | GET | /v3/extensions |
conn_mod_def::GJ1XIqoW1KA::lXboInfiT8Of_s-UwKrJBg |
| Create an Extension (Custom Field / Widget / Dashboard Widget / RTE Plugin / Asset Sidebar Widget) | POST | /extensions |
conn_mod_def::GJ1XJowpsLE::PsZzMGIYTkiKxQ_gbhqiuw |
| Delete a Custom Field (Extension) | DELETE | /v3/extensions/{{customFieldUid}} |
conn_mod_def::GJ1XHqZx_Fs::tFhIoFs-TbCI5e-MMabp4w |
| Delete a Dashboard Widget (Extension) | DELETE | /v3/extensions/{{extensionUid}} |
conn_mod_def::GJ1XH-06GW4::kZxd8bhoQIGRI8qZ8fNrLQ |
| Delete a JSON RTE Plugin (Extension) | DELETE | /v3/extensions/{{jsonRtePluginUid}} |
conn_mod_def::GJ1XH1g48U4::iLOt8xaKSGGaUj6x_jKbQA |
| Delete a Widget (Extension) | DELETE | /v3/extensions/{{widgetUid}} |
conn_mod_def::GJ1XHZiUfhw::zqjrB9LORKq1_DNGZ1OcWg |
| Delete an Asset Sidebar Extension | DELETE | /v3/extensions/{{assetSidebarExtensionUid}} |
conn_mod_def::GJ1XHiPJw7w::2pnNASTIQvW9xbE58nu8_Q |
| Update a Custom Field (Extension) | PUT | /v3/extensions/{{customFieldUid}} |
conn_mod_def::GJ1XIzsn56E::Vxm5JHJrTpadDwydZghehg |
| Update a Dashboard Widget (Extension) | PUT | /v3/extensions/{{extensionUid}} |
conn_mod_def::GJ1XJfvWH4U::FqYnhb1ASGuTNnS_QeEnew |
1 more Extensions actions are available through search.
Entries
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Single Entry (Get Embedded RTE Objects Info) | GET | /v3/content_types/{{contentTypeUid}}/entries/{{entryUid}} |
conn_mod_def::GJ1XDLio3OU::1HKU3bnTQwao7dTvb02nhQ |
| List Entries for a Content Type | GET | /v3/content_types/{{contentTypeUid}}/entries |
conn_mod_def::GJ1XELUIVKs::GRm0mEXMSY-D-HPykwy18Q |
| Create an Entry for a Content Type | POST | /v3/content_types/{{contentTypeUid}}/entries |
conn_mod_def::GJ1XC-doqFE::Of0O9VZBS0uHjks3PSLtWQ |
| Delete a Content Type Entry | DELETE | /v3/content_types/{{contentTypeUid}}/entries/{{entryUid}} |
conn_mod_def::GJ1XDvDhqR0::RGvJr3I-RUyp-mKm1dXX7g |
| Delete a Version Name of an Entry | DELETE | /v3/content_types/{{contentTypeUid}}/entries/{{entryUid}}/versions/{{versionNumber}}/name |
conn_mod_def::GJ1XD4QHoe0::iXs0qouxR4CiaNLTMO9Akg |
| Import an Entry into a Content Type | POST | /v3/content_types/{{contentTypeUid}}/entries/import |
conn_mod_def::GJ1XEz_z_ao::lfXlZOhURwmaGysuGzvG_Q |
| Import an Existing Entry (Create a New Version) | POST | /v3/content_types/{{contentTypeUid}}/entries/{{entryUid}}/import |
conn_mod_def::GJ1XE9wKld8::zCN0gSwDQiqy-p1OVWDRzA |
| Publish an Entry (or Entry Variant) for a Content Type | POST | /v3/content_types/{{contentTypeUid}}/entries/{{entryUid}}/publish |
conn_mod_def::GJ1XGFoqXlw::qMqV-7qMQROSwrlvOC0Lzw |
| Set an Entry’s Workflow Stage (or Request/Accept/Reject Entry Publish Request) | POST | /content_types/{{contentTypeUid}}/entries/{{entryUid}}/workflow |
conn_mod_def::GJ1XhYFiZXg::saAtiC3TSEai797xU30BBw |
| Unlocalize an Entry (in a Content Type) | POST | /v3/content_types/{{contentTypeUid}}/entries/{{entryUid}}/unlocalize |
conn_mod_def::GJ1XFQVzqhI::-2xemXWHR1eNC5sBY6tKew |
| Unpublish an Entry (or Entry Variant) for a Content Type | POST | /v3/content_types/{{contentTypeUid}}/entries/{{entryUid}}/unpublish |
conn_mod_def::GJ1XGO7U76Y::M93yzGgZTv-m189-Gk1iDw |
| Update an Entry (by Content Type UID and Entry UID) | PUT | /v3/content_types/{{contentTypeUid}}/entries/{{entryUid}} |
conn_mod_def::GJ1XDVe-pk4::NFjGxf8TQfa4tcortwNGfg |
Releases
| Action | Method | Path | Action id |
|---|---|---|---|
| Get a Single Release | GET | /v3/releases/{{releaseUid}} |
conn_mod_def::GJ1XSA9ufAs::qr2-X2NNQqm4FK-J6GAzoA |
| Get All Releases (Stack) | GET | /releases |
conn_mod_def::GJ1XSTLFCyA::VoVz053VQVGaIwX5O91mlg |
| Add a Single Item to a Release | POST | /v3/releases/{{releaseUid}}/item |
conn_mod_def::GJ1XRKGhjJk::_c4rUXp-QKi-HKIu4IMnHg |
| Add Multiple Items to a Release | POST | /v3/releases/{{releaseUid}}/items |
conn_mod_def::GJ1XRSvStHY::QJlHYG9_TT-kJSOMuIsAvg |
| Clone a Release (in a Stack) | POST | /v3/releases/{{releaseUid}}/clone |
conn_mod_def::GJ1XRbLh2DQ::fsU2jorBTBq1YDYblfHrbQ |
| Create a Release | POST | /releases |
conn_mod_def::GJ1XRmLc3zc::53sdIrsoTA6v0XL-zsUl0Q |
| Delete a Stack Release | DELETE | /v3/releases/{{releaseUid}} |
conn_mod_def::GJ1XRvUEHdw::JwU-PIxdTsORYR0qxSU7-A |
| Deploy a Release | POST | /v3/releases/{{releaseUid}}/deploy |
conn_mod_def::GJ1XR3f03qc::oqkr8jDpQ0qhFl_yr__yzg |
| Remove Items from a Release (Single or Multiple) | DELETE | /v3/releases/{{releaseUid}}/items |
conn_mod_def::GJ1XSctNJ9w::ULKtUZoSRh6ytK3D1oRyyw |
| Update a Release (Lock/Unlock) | PUT | /v3/releases/{{releaseUid}} |
conn_mod_def::GJ1XSoGeFpE::22rZjj8xRvmomkRPHYKRSg |
| Update a Release’s Items to Their Latest Versions | PUT | /v3/releases/{{releaseUid}}/update_items |
conn_mod_def::GJ1XSzJiO10::bfzC5hfTTy2BwcQhHt0DVw |
Stacks
| Action | Method | Path | Action id |
|---|---|---|---|
| Accept a Stack Ownership Invitation (via Ownership Token) | GET | /v3/stacks/accept_ownership/{{ownershipToken}} |
conn_mod_def::GJ1XTx9cDys::n9AHEH59Syuu5_QOjFBiRA |
| Get a Single Stack | GET | /v3/stacks |
conn_mod_def::GJ1XUUcCFWs::uSE2mfLAQQCPiOXtLq3YMA |
| Get All Stacks | GET | /stacks/ |
conn_mod_def::GJ1XUgvJTH4::89uwveFsQHyyAVZWgkO9Lw |
| List an Organization’s Stacks | GET | /v3/organizations/{{organizationUid}}/stacks |
conn_mod_def::GJ1XPrIbLFU::8awiM6z-R5iMjpS2Z0q3HA |
| Create Stack | POST | /stacks |
conn_mod_def::GJ1XUEJlbQM::Vfa5mLtyRNqCEmp3UkE-Vg |
| Delete a Stack | DELETE | /stacks |
conn_mod_def::GJ1XUL3rfpk::Wsh8abq0TpWnPvzDxNYRKA |
| Share a Stack | POST | /stacks/share |
conn_mod_def::GJ1XVF28xxo::PbnFGlD-TiaA7oyiDX96AQ |
| Transfer Stack Ownership to Other Users | POST | /stacks/transfer_ownership |
conn_mod_def::GJ1XVO27Qnk::gAv3gE8WS-mAHXAAOgbxvw |
| Unshare a Stack | POST | /stacks/unshare |
conn_mod_def::GJ1XVYnyeSw::Vt7LSMSMT4mgkTCjdXearQ |
| Update Stack | PUT | /stacks |
conn_mod_def::GJ1XVhHe534::LdpJrsP8S7-O9s0GmwtrUA |
Taxonomies
| Action | Method | Path | Action id |
|---|---|---|---|
| Export a Taxonomy | GET | /v3/taxonomies/{{taxonomyUid}}/export |
conn_mod_def::GJ1XWJ0j7IQ::3qWtFwDbQyeJpbkLg4z5_g |
| Get a Single Taxonomy (by UID) | GET | /v3/taxonomies/{{taxonomyUid}} |
conn_mod_def::GJ1XWXPNc3c::ew3ISNXCTRO66icD4Csb9w |
| Get All Taxonomies | GET | /taxonomies |
conn_mod_def::GJ1XWtSER7s::swAFrwWFTzm7i4avPKCpjQ |
| Get Ancestors of a Taxonomy Term | GET | /v3/taxonomies/{{taxonomyUid}}/terms/{{termUid}}/ancestors |
conn_mod_def::GJ1XXN9vs3w::yckOlwKNRpKaIvm8461zJg |
| Create a Taxonomy (in a Stack) | POST | /taxonomies/ |
conn_mod_def::GJ1XVywKzBw::MrUvSCWxS0SThOgbc4UlCA |
| Import a Taxonomy (Upload JSON/CSV) | POST | /taxonomies/import |
conn_mod_def::GJ1XXo-YRQQ::o3Jvx1aQQJGNsjT2cG93Nw |
| Localize a Taxonomy | POST | /v3/taxonomies/{{taxonomyUid}} |
conn_mod_def::GJ1XXxdC2xA::nnv6rjD1SGeJDfIHYDH6nw |
| Unlocalize or Delete a Taxonomy | DELETE | /v3/taxonomies/{{taxonomyUid}} |
conn_mod_def::GJ1XYP_N7Ug::FdLHy_ZFR1SmXnbHRO0OGQ |
| Update a Taxonomy | PUT | /v3/taxonomies/{{taxonomyUid}} |
conn_mod_def::GJ1XYiUF6pI::vFKAYtq2Q_iEq8tJk-Mh2w |
ContentTypes
| Action | Method | Path | Action id |
|---|---|---|---|
| Compare Content Types Between Branches | GET | /stacks/branches_compare/content_types |
conn_mod_def::GJ1W_miJh1M::a3S-a2HXQi62SxreQ0jMzA |
| Export a Content Type (Schema) | GET | /v3/content_types/{{contentTypeUid}}/export |
conn_mod_def::GJ1XCPpkbnk::4LoeReZhSfmEfX56xMYQkA |
| Get a Single Content Type | GET | /v3/content_types/{{contentTypeUid}} |
conn_mod_def::GJ1XCY9vuvA::-fGgBodVT3m8vmqurIsm8A |
| List All Content Types in a Stack | GET | /content_types |
conn_mod_def::GJ1XCh-sDzg::rH0ttu5cS4ic_wNGD9aBDQ |
| Create a Content Type | POST | /v3/content_types |
conn_mod_def::GJ1XHQ_95No::_0WhlKFvSN2lTBA3tp-B6w |
| Delete a Content Type | DELETE | /v3/content_types/{{contentTypeUid}} |
conn_mod_def::GJ1XCG_7lbw::q6tW3QEcRuuGzVCis4WbDg |
| Import a Content Type into a Stack | POST | /content_types/import |
conn_mod_def::GJ1XC1Boo4M::SMTwfdIlQkeOQzcDWpolDQ |
| Update a Content Type | PUT | /v3/content_types/{{contentTypeUid}} |
conn_mod_def::GJ1XDe0h0fw::zKpv759eS-mDY6ZdvUsthQ |
GlobalFields
| Action | Method | Path | Action id |
|---|---|---|---|
| Compare a Specific Global Field Between Branches | GET | /v3/stacks/branches_compare/global_fields/{{globalFieldUid}} |
conn_mod_def::GJ1XAEg7KpE::SuUW5W4dTE2qax2fZ5Abaw |
| Export a Global Field | GET | /v3/global_fields/{{globalFieldUid}}/export |
conn_mod_def::GJ1XKTAR924::rTrIxEAtTwKYHlr3lgzWPQ |
| Get a Single Global Field | GET | /v3/global_fields/{{globalFieldUid}} |
conn_mod_def::GJ1XKc9ZuDs::Q--ISfCCTDiq_npyW3hoyw |
| List All Global Fields | GET | /global_fields |
conn_mod_def::GJ1XKqYUiqo::JH3C-EP_R4O_kHtOSXW3HQ |
| Create a Global Field | POST | /global_fields |
conn_mod_def::GJ1XJ84cIj0::iqO95pIBRrCcM26WBPQ8MQ |
| Delete a Global Field | DELETE | /v3/global_fields/{{globalFieldUid}} |
conn_mod_def::GJ1XKKEuoF0::2yrEqh5rRxKsvttX_Cwvjg |
| Import a Global Field | POST | /global_fields/import |
conn_mod_def::GJ1XKzAxN34::3F77ZYDpTeqe4iVyOPOBFQ |
| Update a Global Field | PUT | /v3/global_fields/{{globalFieldUid}} |
conn_mod_def::GJ1XK9LGFv0::iHqczb5hSvyOG1kDAjwiHQ |
Webhooks
| Action | Method | Path | Action id |
|---|---|---|---|
| Export a Webhook | GET | /v3/webhooks/{{webhookUid}}/export |
conn_mod_def::GJ1Xd_3Z06o::iJc2d3QaS8CChBk11VpuvQ |
| Get a Webhook | GET | /v3/webhooks/{{webhookUid}} |
conn_mod_def::GJ1XemJsyjw::dLpDti8gRQu5t9VA2nnpSg |
| List All Webhooks | GET | /webhooks |
conn_mod_def::GJ1XeKCMvPs::bkGDH2YKRDG8ttE1YOhLDQ |
| Create a Webhook (in a Stack) | POST | /v3/webhooks |
conn_mod_def::GJ1Xduoej8Y::w72l7xfAQbCnrJOeDcmukA |
| Delete a Webhook | DELETE | /v3/webhooks/{{webhookUid}} |
conn_mod_def::GJ1Xd3U2iGo::KI5CDukTTSmC5vwQQ6yLcg |
| Import a Webhook | POST | /webhooks/import |
conn_mod_def::GJ1Xeu2mLQ4::9l6LR8dRSL-tKhL5MNSZGQ |
| Import an Existing Webhook (Update via Import) | POST | /v3/webhooks/{{webhookUid}}/import |
conn_mod_def::GJ1Xe4QFQp8::sNnCrRyzSReboPVE-JG0ig |
| Update a Webhook in a Stack | PUT | /v3/webhooks/{{webhookUid}} |
conn_mod_def::GJ1XfKLZab8::NHumDbiuTlajn9UrCiF-Pg |
This lists 90 of 240 actions. For anything not here, call search_one_platform_actions with platform contentstack-content-management. The full catalog is at https://www.withone.ai/knowledge/contentstack-content-management.
When a call fails
The error comes from Contentstack 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/contentstack-content-management
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.