SKILL.md
Contentstack Management SDK – Contentstack Management Python
When to use
- Implementing or changing
Client, Stack, or resource modules (entries, assets, webhooks, …). - Updating
README.mdor public exports for user-visible behavior. - Assessing semver impact of constructor, method, or export changes.
Instructions
Main entry (consumer API)
contentstackmanagement.Clientincontentstack.py: builds CMA endpoint from region / host / scheme, merges headers (authtoken, managementtoken, earlyaccess), constructsAPIClient, optionaloauth_configwithOAuthHandler.
Structure
Stack—contentstack_management/stack/stack.py: stack-scoped resources (content types, entries, assets, branches, webhooks, …).- Org / user —
organizations/,users/,user_session/as applicable. - Resources — packages under
contentstack_management/following existing patterns. - OAuth —
oauth/oauthhandler.py,oauth/oauthinterceptor.py; keep aligned with_APIClientrequest path.
HTTP layer
APIClient.callrequest— central place for method, URL, JSON, files; respect timeout and maxretries.
Extending
- Add methods on the appropriate resource class; align path and payload shapes with CMA docs.
- Prefer routing HTTP through
_APIClientfor consistent retries and OAuth handling.
Docs and versioning
- Exported
Client,Region, and stack helpers should match README andcontentstack_management.init.py. - Document migration for intentional breaking changes.