This article lists the changes in each version of the Uptick API, including removed and renamed fields, new endpoints, deprecations and removal dates. Use it to check what to update before moving an integration to a newer MINOR version. For how versioning works, see the Uptick API overview.
Patch notes
v2.16 (Added Aug, 2026)
Removed the following entries from the
feature_flagsentry returned by/api/v2.x/settings/:LEGACY_MOBILE_WEB_PORTAL. Support for legacy mobile web portals is removed.LEGACY_MOBILE_WEB_PORTAL_VIEW_PROPERTY. Support for legacy mobile web portals is removed.STRICT_TASK_STATUSES. Interrogatefeature_flags.strict_task_statusesinstead.ASSET_COMPONENTS. Interrogatefeature_flags.asset_componentsinstead.ALLOWANCES_ENABLED. Interrogatesettings.ALLOWANCES_ENABLEDinstead.forms_enable_joyfill_formsalways returnedtrue, and is now removed.telemetry_enabledalways returnedtrueand is now removed.prompts_photo_prompt_type. The photo prompt type is now generally available, so its behaviour is always enabled and the flag is no longer returned.
Removed
AccreditationRequirement.promptquestionfield (across all api versions; low usage).Deprecated management of the
DefectQuoteLineItemresource (create/update/delete) via/api/v2.x/defectquotelineitems/CRUD; this will be removed in an upcoming release. Use/api/v2.x/defectquotes/{id}/synchronise_lineitems/instead.Deprecated the
/api/v2.x/defectquotes/{id}/order_lineitems/endpoint; this will be removed in an upcoming release. Pass the ordering index into/api/v2.x/defectquotes/{id}/synchronise_lineitems/instead.Removed
Branch.fax. This is no longer supported.Removed
TaskSession.is_submitted. Interrogatesubmitted_atinstead.Removed
TaskSession.submitted. Interrogatesubmitted_atinstead.Removed
TaskSession.is_approved. Interrogateapproved_atinstead.Removed
DefectQuoteLineItem.product_type. This is no longer supported.Renamed
Asset.systemfield toAsset.parent_asset, andAssetType.systemfield toAssetType.parent_assettype. The?system=filter and autocomplete parameter remain supported until v2.15 is dropped.Renamed
Asset.componentsfield toAsset.child_assets, andAssetType.componentsfield toAssetType.child_assettypes.Removed
PromptAnswerGroup.label. Interrogatekeyinstead.Removed
ServiceTask.due. This has moved toMajorService.due.Removed
ServiceTask.is_majorservice. Use theServiceTask.majorservicerelationship instead.Removed
ServiceTask.from_stock. InterrogateServiceTask.purchaseorderlineiteminstead (null means the line came from stock).Removed handling of
application/jsoncontent type on standard CRUD endpoints. It was never officially supported, and will now error. Useapplication/vnd.api+jsoninstead.Removed
Property.access_signaturereq. Refer toProperty.client_signature_requiredinstead.
v2.15 (Added Jan, 2026)
Removed
Client.current_business_hours. This is no longer supported.Removed
Branch.current_business_hours. This is no longer supported.Removed
BillingCard.postal_fax. This is no longer supported.Removed
ServiceTask.total. This is no longer supported.Removed
ServiceTask.gst. This is no longer supported.Renamed
standardfield onAssetandAssetTyperesources tostandard_maintenance.Removed
Asset.get_standard_maintenance,Asset.get_standard_performance,Asset.get_standard_installationcomputed fields. These can be computed by coalescing the respective fields from theAssetandAssetTyperesources.Removed
ClientGroup.partner_uid. This is no longer supported.Removed
Invoice.statusoptions "SUBMITTED" and "PARTPAID". The former was a duplicate of "AUTHORISED"; the latter was never properly implemented.Renamed
Property.building_stories_above_groundtoProperty.building_storeys_above_ground.Renamed
Property.building_stories_below_groundtoProperty.building_storeys_below_ground.Renamed
ServiceQuote.property_building_stories_above_groundtoServiceQuote.property_building_storeys_above_ground.Renamed
ServiceQuote.property_building_stories_below_groundtoServiceQuote.property_building_storeys_below_ground.Substantial changes to the prompts api:
Added new
PromptSectionresource, for groupingPromptQuestionstogether.Added new
PromptQuestion.sectionfield, for associatingPromptQuestions withPromptSections.Removed the ability to directly update
PromptQuestionandPromptQuestionRuleSets. These are now updated viaupdate_promptsetendpoint on the promptset.The
PromptQuestionendpoint no longer includesHEADERs.Removed the
PromptQuestion.promptsetfield. This relationship is now viaPromptSection.Added a new
PromptAnswerGroupresource, for grouping answers that belong to the samePromptSection.Removed
PromptAnswer.servicetaskfield. The service task can be inferred via thePromptAnswerGrouprelationshipPromptAnswer.answergroup.servicetask.Prompt sections configured with tabular row types support multiple answers to the same questions via answer groups.
The following address fields are structured json blobs rather than raw strings, following the same structure as
Property.address:ServiceQuote.property_addressBillingCard.postal_addressBillingCard.site_addressSupplier.accounts_addressSupplier.purchasing_address
PATCH/POST calls using contenttype
application/jsonreturn 200/201 respectively, instead of 303 redirects. Please note thatapplication/jsonis not officially supported and will likely be removed in a future release.Added new
Action.typevalue:promptset.Removed write access to
PromptAnswer(post-publish change, effective Apr2026). Use PATCH /api/v2.15/prompts/servicetask//edit/ or /api/v2.15/prompts/task//edit/ instead.Removed write access to
PromptAnswerGroup(post-publish change, effective Apr2026). This is no longer supported.
v2.14 (Added June, 2025)
Removed
Task.sourceandTask.source_content_typefields.
AddedTask.source_defect_quote,Task.source_service_quoteandTask.source_taskin their stead.Renamed
/api/v2.x/chat-messages/to/api/v2.x/chatmessages/.
Both endpoints remain accessible via both old and new API versions until support for v2.13 is dropped.Removed
ChatMessage.data_linkscomputed field. This is no longer supported.Added
timelineevents/create_comment/endpoint for creating comment-type events. Attempting to create comment-type events via standard POST returns an error.Added new required
ServiceQuoteProductLineItem.taxcodefield.Added new
ServiceQuoteProductLineItem.taxratefield, for tracking the tax rate as a decimal. Inferred fromtaxcodeif not supplied.Added new required
ServiceQuoteServiceLineItem.taxcodefield.Added new
ServiceQuoteServiceLineItem.taxratefield, for tracking the tax rate as a decimal. Inferred fromtaxcodeif not supplied.The
addressfield on thePropertyresource is a flat structured json blob as opposed to a foreignkey to anAddressresource. The available values arecountry,country_name,display,streetline,city,state,postal_codeandplace_id.
Most notably,timezoneandcoord_lat/coord_lngare no longer stored here.Added new
Property.coordspoint field, for storing the coordinates which previously lived underProperty.address.coord_lat/coord_lng.Added new
Property.timezonefield, for storing the timezone which previously lived underProperty.address.timezone.Removed the
Addressresource and/api/v2.x/addresses/endpoint.The
attributesfield is not present in a response when an api request only asks for relationship fields.Removed
PropertyContact.primary_numberfield. This was a legacy duplicate ofPropertyContact.phone_bh.Replaced
/api/v2.x/remarks/addwith/api/v2.x/remarks/add_remark. It is functionally the same but accepts a flat JSON body instead of a JSONAPI body.
v2.13 (Published Oct, 2024, deprecated in Aug, 2026)
api/v2.x/jobs/is renamed toapi/v2.x/projects, across all api versions. This change did not go through a deprecation cycle, as it was not used by any customers.product,descriptionandunit_priceare removed fromlineitemsin theapi/v2.x/purchaseorders/create_docketendpoint.purchaseorderlineitem_idis required on eachlineitemfor theapi/v2.x/purchaseorders/create_docketendpoint.purchaseorderlineitem_idis required on eachlineitemfor theapi/v2.x/purchaseorders/create_billendpoint.For the
InvoiceLineItem,CreditNoteLineItem,PurchaseOrderLineItemandPurchaseOrderBillLineItemresources:Renamed
tax_ratetotaxcodeand made it required. The old name remains available until support for v2.12 is dropped.Added new
taxratefield, for tracking the tax rate as a decimal. Inferred fromtaxcodeif not supplied.
For the
DefectQuoteLineItemresource:Added new required
taxcodefield.Added new
taxratefield, for tracking the tax rate as a decimal. Inferred fromtaxcodeif not supplied.
Renamed the
DefectQuote.gstfield totax. The old name remains accessible until support for v2.12 is dropped.
v2.12 (Published Feb, 2024, deprecated in Aug, 2026)
Added cursor-based pagination, which can be used as a performant alternative to limit-offset pagination when needing to iterate through a full table of records. Enable by including
?page[cursor]&page[size]=Xin your query. Retrieve a count of objects by including?page[count]in your query. Page count is disabled by default.Removed
RemarkType.standardfield. This was an underused freetext field, that was preventing us from introducing aRemarkType.standardForeignKey in future. The key remains in the response until v2.11 is dropped, however it only returns emptystring.The
?activefilter under the/api/v2.x/remarks/endpoint is deprecated. Use?is_activeinstead. The former will be removed once v2.11 is dropped.Removed
Client.primary_contactfield, flattenedContactDetailsfields ontoClientmodel itself.Removed
ContactDetailsresource. The/api/v2.x/contactdetails/endpoint will be removed once v2.11 is dropped.Renamed
PropertyContact.activetoPropertyContact.is_active. The old name remains accessible until support for v2.11 is dropped.Renamed the
PropertyContact.activefilter tois_active. The old filter remains accessible until support for v2.11 is dropped.
v2.11 (Removed Jan 30, 2026)
RemarkType,RemarkandRemarkEventresources moved namespace frominspectionstoremarks. This affects scoping on associated contenttypes, as well as thereinstate_remarkspermission. The oldinspectionsscope continues being returned for versions prior to 2.11.Removed automatic lineitem generation when creating a new
PurchaseOrderBillresource using the/api/v2.x/purchaseorderbills/endpoint.Added the following read-only fields to the
TaskSessionresource:submitted_at,submitted_by,approved_by,approved_at. The previousis_approvedandsubmittedfields are deprecated but continue to work until removed when v2.10 is dropped.Added a readonly
statusfield to theTaskSessionresource, which is either DRAFT, SUBMITTED, APPROVED or TRASHED.Renamed
/api/v2.x/default-technicians/to/api/v2.x/defaulttechnicians/. Both endpoints remain accessible via both old and new API versions until support for v2.10 is dropped.Removed the
/api/v2.x/payroll/export in favour of/api/v2.x/tasksessions/as this endpoint provides the same functionality.
v2.10 (Removed Jan 30, 2026)
Appointments endpoint,
api/v2.x/appointments/, returns cancelled appointments too.Extra Fields with a widget type of date are required to be in ISO format (yyyy-MM-dd). For versions prior to 2.10 dd/MM/yyyy formatted extra date fields are converted to yyyy-MM-dd on POST/PATCH and reconverted to dd/MM/yyyy on GET.
v2.9 (Removed Dec 21, 2023)
ServiceTasks created via the
api/v2.x/servicetasks/endpoint are expected to haveroutineserviceleveltypeprovided for service work. For versions prior to 2.9, this field is automatically populated using info fromServiceTask.routineif left blank.Replaced the
remarkfield on thePromptAnswerresource with an M2M,remarks.Added endpoint
/api/v2.x/promptsets/for newPromptSetresource.Added endpoint
/api/v2.x/promptquestionrules/for newPromptQuestionRuleresource.Removed
assettypefield fromPromptQuestionresource. You can look it up viapromptset.assettypes.Removed
routineservicetypefield fromPromptQuestionresource. You can look it up viapromptset.routineservicetypes.Renamed
PromptQuestion.routineserviceleveltypestoPromptQuestion.limit_to_routineserviceleveltypesto better communicate what the field is capturing.Updated the set of Asset icon names. You can view the new names by performing an OPTIONS call against
/api/v2.x/assettypes/(note that making this call against older API versions does NOT return the original icon names).Document download URLs are not directly available. The
/api/v2.x/{app}/documents/{id}/documentsurlfield points to/api/v2.x/documents/{uuid}/download. Following this url redirects to an AWS Signed URL with a 60 second expiry.
v2.8 (Removed Dec 21, 2023)
Expanded
PromptQuestion.typechoices from'A', 'R', 'T', 'I', 'D'to'ASSERTION', 'REMARK', 'TEXT', 'INTEGER, 'DECIMAL', respectively.Renamed
labeltohelp_textandheadingtolabelonPromptQuestionresource.Abstracted a portion of the path prefix out from the document upload interface. The interface w.r.t retrieving data (using
/v2/uploads/endpoint) otherwise remains unchanged. Please ensure that you're usingrootas the base path for rendering folders, and not theprefixfrom the upload config.
v2.7 (Removed Dec 21, 2023)
Removed the
access_policecheckreqandaccess_childrencheckreqfields on thePropertyresource. This functionality is accessible through the Accreditations module; specifically theAccreditationRequirementresource at/api/v2.x/accreditationrequirements/.Expensive relations (M2Ms & Reverse ForeignKeys) are not returned by default when hitting a naked endpoint. They must be requested explicitly with the
fields[]query parameter.Renamed
ContacttoPropertyContactand flattened theContactDetailsresource located underPropertyContact.contactonto thePropertyContactresource itself.Introduced a csv download mechanism, which is much more performant, faster, and puts less strain on your server. To use it, instead of tacking
.csvonto the end of your api call, appendgenerate_csv/instead. For example:https://yourserver.onuptick.com/api/v2/properties/generate_csv/. This returns a 'PENDING' status when first hit. Refresh the page after a short wait to receive your csv download link. The.csvapproach is not available, across all API versions.
v2.6 (Removed Dec 21, 2023)
Added a
building_classeschoice field to thePropertyresource. This replaces thebuilding_classandbuilding_typefields, which remain accessible until v2.5 is dropped.Added
bsecure_resolved_guid(actual guid) andbsecure_latest_sticker_guid(guid of most recently attached sticker; gets mapped to actual guid) fields to thePropertyandAssetresources, to be used in place ofbsecure_guidandbsecure_real_guidfields. If you've been using these old fields, apply the following mapping. For thePropertyresourcebsecure_guidis the same asbsecure_resolved_guid; for theAssetresource,bsecure_guidis the same asbsecure_latest_sticker_guidandbsecure_real_guidis the same asbsecure_resolved_guid. The old fields remain accessible via both old and new API versions until support for v2.5 is dropped.Removed
propertyrelationship fromServiceTaskresource. Not accessible via previous API versions either, as it was never used./api/v2.x/pushnotificationtokens/register/requiresplatformto be provided. Must be one ofAPNS|GCM.A
quantityof 0 passed to the/api/v2.x/servicetasks/endpoint remains as 0, rather than getting automatically converted to 1.Renamed
/api/v2.x/form-responses/to/api/v2.x/dynamicformresponses/. Both endpoints remain accessible via both old and new API versions until support for v2.5 is dropped.Renamed
/api/v2.x/dynamicform_templates/to/api/v2.x/dynamicformtemplates/. Both endpoints remain accessible via both old and new API versions until support for v2.5 is dropped.
v2.5 (Removed Dec 21, 2023)
Asset.floorplan_locationsbecameAsset.floorplan_location, as the relationship is one-to-one. Both usages remain accessible until support for v2.4 is dropped.
v2.4 (Removed Dec 21, 2023)
The following resources were renamed:
InspectionItem->AssetInspectionItemType->AssetTypeInspectionItemTag->AssetTagInspectionItemTypeTag->AssetTypeTagInspectionItemTypeVariant->AssetTypeVariant
Renamed all occurences of fields named
inspectionitemandinspection_itemwithasset. This change spans multiple endpoints, and affects the following resources:Asset,AssetType,AssetTag,AssetTypeTag,AssetTypeVariant,PlanLocation,Remark,SuggestedProduct,DefectQuoteLineItem,SignoffItem,ServiceTask,AssetPreset,RemarkType,RoutineServiceType,ServiceRecord,Rectification.Changed
Task.statusfrom a CharField to a ForeignKey relationship on resourceTaskStatus. What was previously stored inTask.statuscan be found underTask.status.id. Affects all endpoints that reference theTaskresource.Added endpoint
/api/v2.x/taskstatuses/, for viewingTaskStatusresources.All datetimes are returned in the timezone of the user performing the request. For example,
2020-01-20T00:32:06.912780Z, for a user with a Melbourne timezone, returns as2020-01-20T11:32:06.912780+11:00. Clients must ensure they understand the+XX:XXtimezone offset suffix, rather than just theZUTC suffix, or always assuming UTC.
v2.3 (Removed Oct 21, 2021)
Renamed a number of endpoints. Both endpoint names remain accessible via both old and new API versions until support for v2.2 is dropped.
/api/v2.x/property-tags/->/api/v2.x/propertytags/./api/v2.x/timeline-events/->/api/v2.x/timelineevents/./api/v2.x/extra-fields/->/api/v2.x/extrafields/./api/v2.x/display-conditions/->/api/v2.x/displayconditions/./api/v2.x/dispatch/->/api/v2.x/dispatches/.
Added endpoint
/api/v2.x/assettags/, for parity with the same endpoint in the v1 api.Filter
content_type_idon/api/v2.x/timelineevents/is renamed tocontent_type. Both filter names remain usable until support for v2.2 is dropped.Removed
is_performedbool field fromServiceTaskresource. Useperformed_datedatetime field instead.Removed
is_quotablebool field fromServiceTaskresource. The concept of "Quotable" ServiceTasks is replaced with a "SuggestedProducts" resource.Added
/api/v2.x/suggestedproducts/endpoint, for interfacing with SuggestedProducts.Tasks with status type CANCELLED are visible through the
/api/v2.x/tasks/endpoint.
v2.2 (Removed Mar 18, 2021)
Renamed
/api/v2.x/task-sessions/to/api/v2.x/tasksessions/. Both endpoints remain accessible via both old and new API versions until support for v2.1 is dropped.Changed
TaskSession.typefrom a CharField to a ForeignKey on model TaskSessionType. What was previously stored inTaskSession.typecan be found underTaskSessionType.key. This affects both the TaskSession endpoints/api/v2.x/task-sessions/and/api/v2.x/tasksessions/, as well as the/api/v2.x/payroll/endpoint.Added endpoint
/api/v2.x/tasksessiontypes/, for accessing and manipulating TaskSessionTypes.
v2.1 (Removed Jun 18, 2020)
Renamed
Remark.failuretoRemark.type. Notes:This is only a field name change. The resource behind the ForeignKey was already called RemarkType and remains this way.
This change affects not only the
remarksendpoint, but all other endpoints that were pulling remarks through via theincludequery param.
Renamed
/api/v2/remark-types/endpoint to/api/v2/remarktypes/. Both endpoints remain accessible via both old and new API versions until support for v2.0 is dropped.
v2.0 (Removed Feb 6, 2020)
Initial release
Recommendations
◀ Previous | Next ▶ |
