Changelog and versioning

The API version is in the path (/v1). Within /v1 we only add: new endpoints, new optional fields, new enum values on fields marked as open. Your code should ignore fields it does not know. Breaking changes ship as /v2 with at least 12 months of overlap; deprecated endpoints and fields return Deprecation and Sunset headers and are announced by email to workspaces that use them. The changelog lives at https://docs.urlcrop.com/api/changelog (RSS available).