Summary
This is a courtesy announcement regarding an upcoming change to our Preview Business Rules APIs. This change is being made in preparation for an upcoming Beta Release, and currently, there are no active customers using these specific Preview APIs.
The row index in Business Rules will be updated from 0-based to 1-based for all Business Rules row APIs.
The following APIs will be updated to use the 1-based row index:
GET /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows/{rowId}
GET /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows
POST /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows
POST /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows/search
PUT /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows/{rowId}
PATCH /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}
Effective Date
Friday, July 4, 2025
Details
The change aims to standardize on 1-based indexing for row indices across all Business Rules operations to ensure consistency. Previously, some operations used 1-based indexing while others used 0-based indexing.
Customer Impact
These APIs are currently in Preview mode and are intended for use in the upcoming Beta Release of Business Rules API. There are no active customers currently using these specific APIs.
For customers who intend to use these APIs as part of the Beta, the row index will now start at 1. Therefore, if previous plans involved using 0 as the start index, it will now be 1.
Impacted Resources
GET /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows/{rowId}
POST /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows
POST /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows/search
GET /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows
PUT /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}/rows/{rowId}
PATCH /v1/organizations/{organizationId}/decisiontables/{tableId}/versions/{version}
Issue References
[PURE-5186]
[RULES-747]
[RULES-837]
Contacts
@Cathal Kane Please reply to this announcement with any questions. This helps the wider developer community benefit from the discussion. We encourage you to use this thread before contacting the designated person directly. Thank you for your understanding.