Agent skill · software engineering · jeremylongshore
appfolio-upgrade-migration
Migrate between AppFolio API versions and handle endpoint changes.
Why this skill is useful
Adds executable scripts for migrating between AppFolio API versions, including version detection and schema transformation functions.
What it needs
Requires bash installed locally. Requires appfolio account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
AppFolio Upgrade & Migration Overview AppFolio property management integrations depend on versioned REST API endpoints that evolve with the platform. Upgrades can rename fields on property and tenant objects, change pagination models, deprecate work-order endpoints, and alter the basic-auth flow. This skill detects your current API version, maps deprecated response shapes to replacements, and rolls back automatically if the new version fails. Prerequisites Current API version prefix documented (e.g., /api/v1/) Access to the AppFolio API changelog and release notes Staging environment with test property and tenant data Client ID and secret stored in environment variables Existing integration test suite that covers core endpoints Instructions 1. Run version detection to compare your active API version against the latest. 2. Review the AppFolio changelog for breaking changes between the two versions. 3. Apply schema migration transforms to property and tenant response objects. 4. Update endpoint URLs from the old version prefix to the new one. 5. Switch pagination from offset to cursor-based if required by the new version. 6. Run the smoke test suite against staging to verify all endpoints respond. 7. Deploy to production with the rollback strategy enabled. 8. Monitor error logs for 410/401 responses indicating missed migration steps. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/appfolio-upgrade-migration--a7a027