Changes
All backward-incompatible changes to the Sequence REST API
Version: 2024-07-30
Billing
- UPDATED Create billing schedule endpoint
- Updated
prices
to match models for Prices API
- Updated
- UPDATED Update billing schedule endpoint
- Removed
type
from request and response models - Removed
discounts
from Billing Schedule creation request - these should now be provided as part of a Phase - Renamed
createAsDraft
toisDraft
on creation request - Renamed
collectionPaymentProvider
topaymentProvider
on creation request - Removed
sequenceAccountId
from response model - Removed
priceIds
from response model - Updated
prices
to match models for Prices API
- Removed
- UPDATED Get billing schedule endpoint
- Updated
prices
to match models for Prices API
- Updated
- UPDATED List billing schedules endpoint
- Updated
prices
to match models for Prices API
- Updated
- UPDATED Activate billing schedule endpoint
- Updated
prices
to match models for Prices API - Addition:
Added dryRun queryParam to validate without persisting
- Updated
- UPDATED Archive billing schedule endpoint
- HTTP method updated from
PUT
toPOST
- Updated
prices
to match models for Prices API
- HTTP method updated from
- NEW Validate taxes on a billing schedule
Collections
Customers
- REMOVED Delete customer endpoint
- UPDATED Archive customer endpoint
- HTTP method updated from
PUT
toPOST
- Added field
organizations
- Removed
contactName
,email
andbillingEmails
fields in favour ofcontacts
- Removed field
telephone
- Removed field
deletedAt
- HTTP method updated from
- UPDATED Create customer endpoint
- Added optional
parentId
field to request - Added field
organizations
to response - Removed
contactName
,email
andbillingEmails
fields in favour ofcontacts
in request and response - Removed field
telephone
from request and response - Removed field
deletedAt
from response
- Added optional
- UPDATED Update customer endpoint
- Added optional
parentId
field to request - Added field
organizations
to response - Removed
contactName
,email
andbillingEmails
fields in favour ofcontacts
in request and response - Removed field
telephone
from request and response - Removed field
deletedAt
from response
- Added optional
- UPDATED List customers endpoint
- Added field
organizations
- Removed
contactName
,email
andbillingEmails
fields - Removed field
telephone
- Removed field
deletedAt
- Added field
- UPDATED Get customer endpoint
- Added field
organizations
- Removed
contactName
,email
andbillingEmails
fields in favour ofcontacts
- Removed field
telephone
- Removed field
deletedAt
- Added field
- NEW Create customer organization endpoint
- NEW Add customer organization member endpoint
- NEW Replace customer organization members endpoint
Invoices
Products
- UPDATED Archive list price endpoint
- HTTP method updated from
PUT
toPOST
- HTTP method updated from
Taxes
- UPDATED Archive tax rate endpoint
- HTTP method updated from
PUT
toPOST
- HTTP method updated from
Version: 2024-05-09
Naming improvements and simplifications across billing, customers, products, taxes and usage APIs. Further details below.
Billing
-
Removed
POST /discounts
endpoint. -
Renamed
externalIds
tointegrationIds
inPrice
requests and updated model to be{service: string, id: string}
. -
Renamed
externalIds
tointegrationIds
inPrice
responses and updated model to be{service: string, id: string, lastSynced: timestamp}
. -
Removed
sequenceAccountId
anddeletedAt
from listPrice
response model. -
Removed
sequenceAccountId
fromPrice
deletion response model. -
Removed
sequenceAccountId
fromPrice
creation response model. -
Renamed
parameters
tocustomMetricParameters
inPrice
request and response models. -
Updated the following fields on seat-based pricing structure:
- Renamed
seatTypeId
toseatMetricId
- Removed values
USE_FIRST
andPRORATE_ALL_CHANGES
fromprorationStrategy
- Renamed
includedSeats
tocontractedMinimumSeats
- Removed
chargeMethod
- Renamed
-
Updated the following fields on the
Billing Schedule
models:- Removed
type
from request and response models - Removed
discounts
fromBilling Schedule
creation request - these should now be provided as part of aPhase
- Renamed
createAsDraft
toisDraft
on creation request - Renamed
collectionPaymentProvider
topaymentProvider
on creation request - Removed
sequenceAccountId
from response model - Removed
priceIds
from response model
- Removed
Collections
- Updated the following URLs
POST /billing-schedule-settings
->POST /payments/settings/billing-schedules
GET /billing-schedule-settings/for-billing-schedule/{id}
->GET /payments/settings/billing-schedules/for-billing-schedule/{id}
GET /billing-schedule-settings/{id}
->GET /payments/settings/billing-schedules/{id}
PUT /billing-schedule-settings/{id}
->PUT /payments/settings/billing-schedules/{id}
DELETE /billing-schedule-settings/{id}
->DELETE /payments/settings/billing-schedules/{id}
POST /invoice-settings
->POST /payments/settings/invoices
GET /invoice-settings/for-invoice/{id}
->GET /payments/settings/invoices/for-invoice/{id}
GET /invoice-settings/{id}
->GET /payments/settings/invoices/{id}
PUT /invoice-settings/{id}
->PUT /payments/settings/invoices/{id}
DELETE /invoice-settings/{id}
->DELETE /payments/settings/invoices/{id}
POST /customer-settings
->POST /payments/settings/customers
GET /customer-settings/{id}
->GET /payments/settings/customers/{id}
PUT /customer-settings/{id}
->PUT /payments/settings/customers/{id}
DELETE /customer-settings/{id}
->DELETE /payments/settings/customers/{id}
Customers
- Renamed
externalIds
tointegrationIds
inCustomer
requests and updated model to be{service: string, id: string}
. - Renamed
externalIds
tointegrationIds
inCustomer
responses and updated model to be{service: string, id: string, lastSynced: timestamp}
.
Products
- Removed
sequenceAccountId
fromProduct
request and response models.
Taxes
- Removed
subRates
fromTax Rate
request and response models. - Removed
sequenceAccountId
fromTax Rate
response models.
Usage
- Renamed
Seat Types
toSeat Metrics
and updated URLs to be/seat-metrics
. - Removed
sequenceAccountId
fromSeat Metric
response model. - Renamed
sequenceUserId
tocreatedBy
onSeat Metric
response model and removed it from request model. - Renamed
key
toseatType
onSeat Metric
request and response models. - Renamed
Seat Snapshots
toSeat Events
and updated URLs to be/seat-events
. - Removed
seatChanges
fromSeat Event
request and response models.
Version: 2024-01-01
Initial release of the versioned Sequence REST API.