Release schedule

Features get added to the Urban API progressively. New releases occur almost every last Wednesday of the month.
You can find out about the latest updates, changes, and fixes in the individual release notes.

Deprecation policy

Deprecated GraphQL types or fields are annotated in the GraphQL schema with the @deprecated directive, as in the following example:

1
2
 urbanEvent(urbanDatabaseId: PortalItemId!, globalID: GlobalID!): UrbanEvent
    @deprecated(reason: "Use Plans or Projects. (Removal date: 2021-02-01)")

The reason field in the deprecation notice includes useful information such as migration recommendations as well as the removal date for the deprecated item. Deprecated fields or types may be removed from the from the Urban API once the removal date has been reached. New deprecations and breaking changes are also noted in Urban API release announcements.