Changelog

keep track of changes and upgrades to the tidy api tidy api change information your api version controls the api and webhook behavior you see (for example, what properties you see in responses) the tidy api uses semantic versioning (semver) for changes, so there should be no breaking changes unless the api increments by a major version (e g 1 0 to 2 0) when using your application, any minor version updates will happen automatically, as we expect no breaking changes any major version updates will require you to manually update your application to access the latest major version tidy considers the following changes to be backwards compatible adding new api resources adding new optional request parameters to existing api methods adding new properties to existing api responses changing the order of properties in existing api responses changing the length or format of opaque strings, such as object ids, error messages, and other human readable strings you can safely assume object ids we generate will never exceed 255 characters, but you should be able to handle ids of up to that length adding new event types your webhook listener should gracefully handle unfamiliar event types api changelog 1 6 2 sep 2023 https //github com/tidyapp/tidy api spec/blob/master/docs/changelog md#162 sep 2023 added more types you are able to report issues for general improvements on descriptions and documentation 1 6 1 feb 2023 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#161 feb 2023 added fields 1 6 0 sep 2022 webhook updates https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#160 sep 2022 webhook updates in this month, we added 2 requested features to webhooks you can now specify the events you wish to be notified on prior to this release, all filtering for events needed to be done on the client side now, you can specify the events you want to filter by within tidy, so you will only get the vents you want we have added the ability to specify a webhook as for slack, with other channels coming soon this will ensure your webhook is formatted correctly for that channel ms teams is coming soon, reach out to your account manager for early access 1 5 5 aug 2022 teams and advanced permissions https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#155 aug 2022 teams and advanced permissions this is not a feature directly related to the api, but our new teams and advanced permissions feature is live! if you configure teams, users, or permissions in the console, all changes via the api will act as an admin but users will be limited to their permissions as set up in the console we are looking for feedback from customers on what kind of teams or permission related items need to be set up in the api please reach out to use to let us know how our api can support your teams and permissions related usecases 1 5 0 feb 2022 guestreservations and issues https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#150 feb 2022 guestreservations and issues one of our biggest releases yet! (new) guest reservations you can now add "guest reservations" via the api this was very highly requested this is designed for when you are tracking guests coming and going from your property, and want to schedule jobs around them for example, someone checking in/out of an airbnb if you have automatic booking enabled for the address, then job requests will automatically be made following your settings note automatic booking is controlled via the console customers who previously created jobs directly via the api may want to consider switching to creating reservations instead we now offer the following endpoints for guestreservation model get /guest reservations post /guest reservations get /guest reservations/{guest reservation id} delete /guest reservations/{guest reservation id} (new) issues we have also made major improvements to the issue model, allowing more endpoints to manage issues (such as damage reports) reported by pros or by your team members we now offer the following endpoints for issue model get /issues post /issues get /issues/{issue id} delete /issues/{issue id} post /issues/{issue id}/resolve jobs the job model now returns the url, so applications can redirect their users to the job details page in the tidy app/console 1 4 2 dec 2021 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#142 dec 2021 misc bug fixes with no expected impact on customers using public api 1 4 1 nov 2021 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#141 nov 2021 misc bug fixes with no expected impact on customers using public api 1 4 0 oct 2021 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#140 oct 2021 issues 1 3 2 sep 2021 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#132 sep 2021 misc bug fixes with no expected impact on customers using public api 1 3 1 aug 2021 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#131 aug 2021 misc bug fixes with no expected impact on customers using public api 1 3 0 july 2021 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#130 july 2021 misc bug fixes with no expected impact on customers using public api 1 2 1 may 2021 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#121 may 2021 misc bug fixes with no expected impact on customers using public api 1 2 0 mar 2021 pros and todolist https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#120 mar 2021 pros and todolist pros post /pros todolist get /to do lists 1 1 2 jan 2021 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#112 jan 2021 misc bug fixes with no expected impact on customers using public api 1 1 1 nov 2020 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#111 nov 2020 misc bug fixes with no expected impact on customers using public api 1 1 0 oct 2020 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#110 oct 2020 booking availbilities (bookingtimeslots model) get /booking availabilities 1 0 2 sep 2020 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#102 sep 2020 misc bug fixes with no expected impact on customers using public api 1 0 1 aug 2020 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#101 aug 2020 misc bug fixes with no expected impact on customers using public api 1 0 0 july 2020 first public release https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#100 july 2020 first public release address model post /address get /addresses get /addresses/{address id} put /addresses/{address id} delete /addresses/{address id} job model post /jobs get /jobs get /jobs/{job id} put /jobs/{job id} post /jobs/{job id}/cancel 0 9 1 may 2020 https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#091 may 2020 misc bug fixes with no expected impact on customers using public api 0 9 0 mar 2020 initial beta release https //apidocs tidy com/docs/api reference/bcae7df9d9835 changelog#090 mar 2020 initial beta release