contentstack-content-management

name

contentstack-content-management

description

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. Read and write Contentstack Content Management data through One: assets, extensions, entries, releases, stacks, taxonomies and more, 240 actions with real parameter documentation. Use whenever the user asks to look something up in Contentstack Content Management, create or update a record there, or build code against the Contentstack Content Management API.

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

1. Find the action in the table below, or call search_one_platform_actions with platform contentstack-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 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

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}}

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

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.