API Reference
Customer Library API
Verified customer-library token, listing, webview-library, expansion, review, and claim boundaries.
SoundSync
Verified library endpoints
These endpoints are route-backed and scoped by customer/library token where noted.
/api/library
Return the portal/library payload for a signed-in customer account.
- Auth
- Account Bearer session token
- Scope
- Current customer-account session and verified customer ownership. Store-scoped sessions remain confined to their storefront; a legacy serial/download token is not account sign-in.
- Request fields
- query token: string
- query download_token: string
- query libraryToken: string
- Returns
- Products, subscriptions, licenses/serials, orders, marketing preferences, account profile, support, and download_token.
- Side effects
- None for GET endpoints unless noted.
- Notes
- Requires a current customer-account session, either shared SoundSync sign-in or an authorized store-scoped customer session. A bare legacy serial/download proof returns 403 CUSTOMER_ACCOUNT_REQUIRED. The query names token, download_token and libraryToken are transport aliases where documented, not permission to substitute a different token type. Prefer Authorization: Bearer to keep credentials out of URLs. When account-token session verification is unavailable, fail closed with 503 SESSION_VERIFICATION_UNAVAILABLE. Retry after recovery; do not treat it as authorization or confirmed revocation. A verified revoked account session returns 401 LIBRARY_SESSION_REVOKED. SoundSync-wide customer suspension returns 403 CUSTOMER_ACCOUNT_RESTRICTED, including for an existing shared account session; store closure remains store-scoped. Shared library tokens follow their own token/ownership checks and do not replace required customer-account sign-in.
Request, response and error reference
Query and header parameters
[
{
"name": "token",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "download_token",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "libraryToken",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
}
]
HTTP 200 response (application/json)
{
"type": "object",
"properties": {
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"subscriptions": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"licenses": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"orders": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"prefs": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"profile": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"support": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"download_token": {
"type": "string"
}
},
"additionalProperties": true
}
Documented failures: 401, 403, 503.
Operation errors: SESSION_VERIFICATION_UNAVAILABLE, LIBRARY_SESSION_REVOKED, CUSTOMER_ACCOUNT_RESTRICTED, CUSTOMER_STORE_CLOSED, CUSTOMER_ACCOUNT_REQUIRED.
/api/license/v1/library-token
Issue or return a customer library token for plugin/webview customer-library access.
- Auth
- x-ss-app-id + x-ss-plugin-key + x-ss-plugin-secret OR x-ss-app-id + x-ss-product-id + x-soundsync-public-client (matching generated native client)
- Scope
- Customer/library session scope.
- Request fields
- query instance_id: string
- query validation_token: string
- query plugin_session_id: string
- Returns
- Library token response used by HISE storefront package and webview-library flows.
- Side effects
- None for GET endpoints unless noted.
Request, response and error reference
Query and header parameters
[
{
"name": "instance_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "validation_token",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "plugin_session_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
}
]
HTTP 200 response (application/json)
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"token": {
"type": "string"
},
"library_token": {
"type": "string"
},
"expiresIn": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": true
}
Documented failures: 400, 403, 500.
/api/license/v1/library-token
Issue or return a customer library token for plugin/webview customer-library access.
- Auth
- x-ss-app-id + x-ss-plugin-key + x-ss-plugin-secret OR x-ss-app-id + x-ss-product-id + x-soundsync-public-client (matching generated native client)
- Scope
- Customer/library session scope.
- Request fields
- instance_id: string
- machine_id: string
- product_id: integer
- plugin_version: string
- version: string
- license_key: string
- serial: string
- email: string
- validation_token: string
- token: string
- activationId: value
- licenseReference: string
- plugin_session_id: string
- key: string
- Returns
- Library token response used by HISE storefront package and webview-library flows.
- Side effects
- None for GET endpoints unless noted.
Request, response and error reference
Request (application/json)
{
"type": "object",
"properties": {
"instance_id": {
"type": "string"
},
"machine_id": {
"type": "string"
},
"product_id": {
"type": "integer",
"minimum": 1
},
"plugin_version": {
"type": "string"
},
"version": {
"type": "string"
},
"license_key": {
"type": "string"
},
"serial": {
"type": "string"
},
"email": {
"type": "string",
"format": "email"
},
"validation_token": {
"type": "string"
},
"token": {
"type": "string"
},
"activationId": {
"oneOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "string",
"pattern": "^[1-9][0-9]*$"
}
]
},
"licenseReference": {
"type": "string"
},
"plugin_session_id": {
"type": "string"
},
"key": {
"type": "string"
}
},
"additionalProperties": true
}
HTTP 200 response (application/json)
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"token": {
"type": "string"
},
"library_token": {
"type": "string"
},
"expiresIn": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": true
}
Documented failures: 400, 403, 500.
/api/license/v1/webview-library
Return webview customer-library payload for plugin-hosted library experiences.
- Auth
- x-ss-app-id + x-ss-plugin-key + x-ss-plugin-secret OR x-ss-app-id + x-ss-product-id + x-soundsync-public-client (matching generated native client)
- Scope
- Customer library and product/storefront scope.
- Request fields
- query instance_id: string
- query validation_token: string
- query plugin_session_id: string
- Returns
- Customer library payload suitable for in-plugin WebView use.
- Side effects
- None for GET endpoints unless noted.
Request, response and error reference
Query and header parameters
[
{
"name": "instance_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "validation_token",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "plugin_session_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
}
]
HTTP 200 response (application/json)
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
},
"libraryToken": {
"type": "string"
},
"library_token": {
"type": "string"
},
"download_token": {
"type": "string"
},
"expiresIn": {
"type": "integer",
"minimum": 0
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"subscriptions": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
}
},
"additionalProperties": true
}
Documented failures: 400, 403, 500.
/api/license/v1/webview-library
Return webview customer-library payload for plugin-hosted library experiences.
- Auth
- x-ss-app-id + x-ss-plugin-key + x-ss-plugin-secret OR x-ss-app-id + x-ss-product-id + x-soundsync-public-client (matching generated native client)
- Scope
- Customer library and product/storefront scope.
- Request fields
- instance_id: string
- machine_id: string
- product_id: integer
- plugin_version: string
- version: string
- license_key: string
- serial: string
- email: string
- validation_token: string
- token: string
- activationId: value
- licenseReference: string
- plugin_session_id: string
- key: string
- Returns
- Customer library payload suitable for in-plugin WebView use.
- Side effects
- None for GET endpoints unless noted.
Request, response and error reference
Request (application/json)
{
"type": "object",
"properties": {
"instance_id": {
"type": "string"
},
"machine_id": {
"type": "string"
},
"product_id": {
"type": "integer",
"minimum": 1
},
"plugin_version": {
"type": "string"
},
"version": {
"type": "string"
},
"license_key": {
"type": "string"
},
"serial": {
"type": "string"
},
"email": {
"type": "string",
"format": "email"
},
"validation_token": {
"type": "string"
},
"token": {
"type": "string"
},
"activationId": {
"oneOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "string",
"pattern": "^[1-9][0-9]*$"
}
]
},
"licenseReference": {
"type": "string"
},
"plugin_session_id": {
"type": "string"
},
"key": {
"type": "string"
}
},
"additionalProperties": true
}
HTTP 200 response (application/json)
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"status": {
"type": "string"
},
"libraryToken": {
"type": "string"
},
"library_token": {
"type": "string"
},
"download_token": {
"type": "string"
},
"expiresIn": {
"type": "integer",
"minimum": 0
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"subscriptions": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
}
},
"additionalProperties": true
}
Documented failures: 400, 403, 500.
/api/library/claim
Claim an external reseller/partner order item into the authenticated customer/developer account.
- Auth
- Account Bearer session token
- Scope
- Public, customer-token, developer-user, or scoped partner API surface as noted.
- Request fields
- claim: string
- claim_token: string
- Returns
- Claim result or LIBRARY_CLAIM_FAILED error.
- Side effects
- Claims an external reseller order item when the claim token is valid.
- Notes
- Requires an account JWT and a supported private claim token. claim is also accepted as a query alias. It does not create payment authority.
Request, response and error reference
Request (application/json)
{
"type": "object",
"properties": {
"claim": {
"type": "string"
},
"claim_token": {
"type": "string"
}
},
"additionalProperties": true
}
HTTP 200 response (application/json)
{
"type": "object",
"properties": {
"claimed": {
"type": "boolean"
},
"redirect_to": {
"type": "string"
},
"customer_id": {
"type": "integer",
"minimum": 1
},
"product": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 1
},
"name": {
"type": "string"
}
},
"additionalProperties": true
},
"order": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 1
},
"external_order_id": {
"type": "string"
}
},
"additionalProperties": true
},
"license": {
"type": "object",
"properties": {
"serial": {
"type": [
"string",
"null"
]
},
"entitlement_id": {
"type": [
"integer",
"null"
]
},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
Documented failures: 400, 500, 503.
SoundSync
Purchase to library flow
This is the verified conceptual flow; do not expose internal-only endpoints.
-
Purchase/order
Checkout or partner fulfillment records product access.
-
Entitlement
Entitlement state is the access source used by delivery.
-
Customer account/link
Customer identity service resolves user/customer IDs from the token.
-
Library item
GET /api/library returns products, serials/licenses, subscriptions, and support context.
-
Download
Download links point to entitlement-gated delivery routes.
-
Plugin activation
Licensing endpoints remain separate from library listing.
Public boundary
Customer website UI, embedded customer library, in-plugin WebView library, and developer API access are separate surfaces. Do not document internal customer tables or admin routes as public APIs.
SoundSync
Customer activation reset
/api/library/licenses/:kind/:licenseId/reset-activations
Reset the current customer's eligible device activations
- Auth
- Account Bearer session token
- Scope
- License ownership, developer reset enablement, cooldown, and storefront scope are checked.
- Request fields
- query storefront: string
- expectedLastResetAt: string,null (required)
- Returns
- Updated reset result or an eligibility/conflict error; reload before another action.
- Notes
- kind is serial or entitlement. Account Bearer token only, not a shared library/download link. Send null before the first reset or the exact last value read. Enablement, cooldown, current active devices and stale-state conflicts are checked. When account-token session verification is unavailable, fail closed with 503 SESSION_VERIFICATION_UNAVAILABLE. Retry after recovery; do not treat it as authorization or confirmed revocation. A verified revoked account session returns 401 LIBRARY_SESSION_REVOKED. SoundSync-wide customer suspension returns 403 CUSTOMER_ACCOUNT_RESTRICTED, including for an existing shared account session; store closure remains store-scoped. Shared library tokens follow their own token/ownership checks and do not replace required customer-account sign-in.
Request, response and error reference
Query and header parameters
[
{
"name": "storefront",
"in": "query",
"schema": {
"type": "string"
},
"required": false,
"description": ""
}
]
Request (application/json)
{
"type": "object",
"properties": {
"expectedLastResetAt": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"expectedLastResetAt"
],
"additionalProperties": true
}
HTTP 200 response (application/json)
{
"type": "object",
"properties": {
"reset": {
"type": "boolean"
},
"resetCount": {
"type": "integer"
},
"serialCount": {
"type": "integer"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
Documented failures: 400, 500, 503, 401, 403.
Operation errors: SESSION_VERIFICATION_UNAVAILABLE, LIBRARY_SESSION_REVOKED, CUSTOMER_ACCOUNT_RESTRICTED, CUSTOMER_STORE_CLOSED.
Customer activation resets, when enabled
Developers can allow customer self-service resets for supported serial and entitlement licenses, with a configured cooldown. Only the signed-in owner of the license can request a reset. The confirmation clears the affected device activations and sessions together while preserving the license and product ownership.
A reset is not a refund, a new serial, or unlimited extra devices. Customers must reload the current state and wait for the next eligible reset when a cooldown applies.
Current access and previous records
The customer account separates current licenses and plans from Previous licenses and Previous subscriptions. Ended or inactive records stay available in expandable history; a plan with remaining eligible paid-through access is not hidden merely because cancellation is scheduled.
A signed-in marketplace customer who already owns a product can open their library and downloads from its product page. This is an account-specific lookup, not a public ownership list. License-reset cooldowns show the next eligible date; resetting activations does not create another license.
Account sessions must be verifiable
A signed account token is not enough on its own: customer account requests also check that the session is still allowed. If that check is unavailable, protected library, invoice, review, device-reset, download and customer-token activation requests stop before returning private data or performing the protected action.
503 SESSION_VERIFICATION_UNAVAILABLE means verification could not finish. Retry after service recovery; it does not mean that the purchase disappeared or the session was confirmed revoked. A confirmed revoked session returns 401 LIBRARY_SESSION_REVOKED and requires sign-in again. Do not grant access on either response.
Shared library/download tokens retain their separate token and ownership checks. Optional storefront personalization can fall back to anonymous browsing when customer identity cannot be established; that does not authorize a private download. This account-session check does not replace the signed JUCE offline-grant policy.
SoundSync suspension and store restrictions
A SoundSync-wide customer-account suspension blocks customer library and download authorization, including requests made with an existing signed-in session. A restriction imposed by one store remains scoped to that store; unrelated stores remain available unless the SoundSync account is also suspended.
Suspension does not delete purchase history or create a refund. Contact SoundSync support about a platform restriction and the developer about a store restriction. A previously issued storage link can remain usable until it expires; already downloaded files cannot be recalled by an account restriction.
SoundSync
Deactivate a single currently owned device
/api/library/licenses/{kind}/{licenseId}/machines/{activationId}/deactivate
Deactivate one current owned device, preserving the license and other devices
- Auth
- Account Bearer session token
- Scope
- Signed-in customer account, owned serial/entitlement and device; a store-only session remains bound to its developer. Shared download links cannot mutate devices.
- Request fields
- query storefront: string
- expectedGeneration: string (required)
- Returns
- HTTP 200: deactivated, message.
- Notes
- kind is serial or entitlement. Read machines[].activationId and generation from the current library; generation is a stale-view check, not authorization. Reload on 409. This is distinct from a full activation reset/cooldown, refund and offline-grace expiry. An already deactivated device can return deactivated:false. When account-token session verification is unavailable, fail closed with 503 SESSION_VERIFICATION_UNAVAILABLE. Retry after recovery; do not treat it as authorization or confirmed revocation. A verified revoked account session returns 401 LIBRARY_SESSION_REVOKED. SoundSync-wide customer suspension returns 403 CUSTOMER_ACCOUNT_RESTRICTED, including for an existing shared account session; store closure remains store-scoped. Shared library tokens follow their own token/ownership checks and do not replace required customer-account sign-in.
Request, response and error reference
Query and header parameters
[
{
"name": "storefront",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
}
]
Request (application/json)
{
"type": "object",
"properties": {
"expectedGeneration": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": true,
"required": [
"expectedGeneration"
]
}
HTTP 200 response (application/json)
{
"type": "object",
"properties": {
"deactivated": {
"type": "boolean"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
Documented failures: 400, 401, 403, 404, 409, 429, 500, 503.
Operation errors: MACHINE_CONFIRMATION_REQUIRED, MACHINE_STATE_CHANGED, LICENSE_STATE_CHANGED, CUSTOMER_STORE_CLOSED, STOREFRONT_SESSION_SCOPE, SESSION_VERIFICATION_UNAVAILABLE, LIBRARY_SESSION_REVOKED, CUSTOMER_ACCOUNT_RESTRICTED.
Keep owned products when a plan ends
The library can show effective access from a collection without creating a second paid purchase. When an independently available one-time offer exists, an eligible subscriber can use Buy to keep. It appears only where the product and offer are currently sellable; it is not a promise that every subscription item is sold separately.
Downloads select currently permitted product-version files and can use the supported current-file fallback for older releases without attachments. Protected-only expansion access delivers its .sspc package rather than exposing the raw source archive. A missing file, incompatible bank and missing ownership are different support cases.
Replace old serial-token library views
GET /api/me and GET /api/redeem/me are retired. They return HTTP 410 with LEGACY_CUSTOMER_LIBRARY_RETIRED and point to /api/library; they no longer return serial or product lists, delivery details or download tokens, and do not backfill entitlements. GET /api/customers/me is also retired under LEGACY_CUSTOMER_API_RETIRED.
Use the current customer sign-in and /api/library authentication contract. An old download_token is not a replacement for a current account session. This change does not retire serial redemption, remove purchases or alter HISE/JUCE licensing, product Access settings, signed offline grace or already-issued grants.
Replace anonymous redemption with the customer account
The old anonymous combined and two-step redemption APIs below return HTTP 410 with LEGACY_REDEMPTION_RETIRED. They do not accept serial claims, update customer details, return other products or serials, issue tokens or record redemption usage. An old temporary or download token does not reactivate them.
Use /account#redeem-serial for the customer journey and POST /api/library/redeem-serial with its documented signed-in account checks for an integration. Do not forward an old request body or put an email, serial or private token in the account URL. The old branded.html page opens this account journey on the same storefront, without carrying query parameters.
SoundSync
Retired anonymous redemption APIs
/api/redeem
Retired legacy view; use the documented replacement
- Auth
- Public request; operation-specific verification still applies
- Scope
- Retired anonymous flow; no serial, customer, entitlement or account authorization is performed.
- Returns
- HTTP 410: retired compatibility response with code, documentation and replacement path; no records are returned.
- Side effects
- None; no data is queried, exported or changed.
- Notes
- Always returns 410 LEGACY_REDEMPTION_RETIRED before the old handler, including with a previously issued temp_token or download_token. Submitted identity, serial and token fields are ignored. No customer record, serial claim, entitlement, usage charge, email or token is created, changed or returned. Cache-Control is private, no-store. Sign in through /account#redeem-serial and use POST /api/library/redeem-serial with its current customer-account contract. Do not replay the old request body at another URL or treat a supplied email as proof of ownership. Current native /api/license/v1 claims, library redemption, downloads, telemetry and provider webhooks are separate and unchanged.
Request, response and error reference
Legacy operation. Use the current scoped APIs for new integrations.
No request body fields are read by this operation.
HTTP 410 response (application/json)
{
"type": "object",
"properties": {
"code": {
"const": "LEGACY_REDEMPTION_RETIRED"
},
"message": {
"type": "string"
},
"documentation": {
"const": "/docs/api/customer-library"
},
"replacement": {
"const": "/api/library/redeem-serial"
},
"accountUrl": {
"const": "/account#redeem-serial"
}
},
"additionalProperties": true,
"required": [
"code",
"message",
"documentation",
"replacement",
"accountUrl"
]
}
/api/redeem/initiate
Retired legacy view; use the documented replacement
- Auth
- Public request; operation-specific verification still applies
- Scope
- Retired anonymous flow; no serial, customer, entitlement or account authorization is performed.
- Returns
- HTTP 410: retired compatibility response with code, documentation and replacement path; no records are returned.
- Side effects
- None; no data is queried, exported or changed.
- Notes
- Always returns 410 LEGACY_REDEMPTION_RETIRED before the old handler, including with a previously issued temp_token or download_token. Submitted identity, serial and token fields are ignored. No customer record, serial claim, entitlement, usage charge, email or token is created, changed or returned. Cache-Control is private, no-store. Sign in through /account#redeem-serial and use POST /api/library/redeem-serial with its current customer-account contract. Do not replay the old request body at another URL or treat a supplied email as proof of ownership. Current native /api/license/v1 claims, library redemption, downloads, telemetry and provider webhooks are separate and unchanged.
Request, response and error reference
Legacy operation. Use the current scoped APIs for new integrations.
No request body fields are read by this operation.
HTTP 410 response (application/json)
{
"type": "object",
"properties": {
"code": {
"const": "LEGACY_REDEMPTION_RETIRED"
},
"message": {
"type": "string"
},
"documentation": {
"const": "/docs/api/customer-library"
},
"replacement": {
"const": "/api/library/redeem-serial"
},
"accountUrl": {
"const": "/account#redeem-serial"
}
},
"additionalProperties": true,
"required": [
"code",
"message",
"documentation",
"replacement",
"accountUrl"
]
}
/api/redeem/complete
Retired legacy view; use the documented replacement
- Auth
- Public request; operation-specific verification still applies
- Scope
- Retired anonymous flow; no serial, customer, entitlement or account authorization is performed.
- Returns
- HTTP 410: retired compatibility response with code, documentation and replacement path; no records are returned.
- Side effects
- None; no data is queried, exported or changed.
- Notes
- Always returns 410 LEGACY_REDEMPTION_RETIRED before the old handler, including with a previously issued temp_token or download_token. Submitted identity, serial and token fields are ignored. No customer record, serial claim, entitlement, usage charge, email or token is created, changed or returned. Cache-Control is private, no-store. Sign in through /account#redeem-serial and use POST /api/library/redeem-serial with its current customer-account contract. Do not replay the old request body at another URL or treat a supplied email as proof of ownership. Current native /api/license/v1 claims, library redemption, downloads, telemetry and provider webhooks are separate and unchanged.
Request, response and error reference
Legacy operation. Use the current scoped APIs for new integrations.
No request body fields are read by this operation.
HTTP 410 response (application/json)
{
"type": "object",
"properties": {
"code": {
"const": "LEGACY_REDEMPTION_RETIRED"
},
"message": {
"type": "string"
},
"documentation": {
"const": "/docs/api/customer-library"
},
"replacement": {
"const": "/api/library/redeem-serial"
},
"accountUrl": {
"const": "/account#redeem-serial"
}
},
"additionalProperties": true,
"required": [
"code",
"message",
"documentation",
"replacement",
"accountUrl"
]
}
/api/redeem/redeem/initiate
Retired legacy view; use the documented replacement
- Auth
- Public request; operation-specific verification still applies
- Scope
- Retired anonymous flow; no serial, customer, entitlement or account authorization is performed.
- Returns
- HTTP 410: retired compatibility response with code, documentation and replacement path; no records are returned.
- Side effects
- None; no data is queried, exported or changed.
- Notes
- Always returns 410 LEGACY_REDEMPTION_RETIRED before the old handler, including with a previously issued temp_token or download_token. Submitted identity, serial and token fields are ignored. No customer record, serial claim, entitlement, usage charge, email or token is created, changed or returned. Cache-Control is private, no-store. Sign in through /account#redeem-serial and use POST /api/library/redeem-serial with its current customer-account contract. Do not replay the old request body at another URL or treat a supplied email as proof of ownership. Current native /api/license/v1 claims, library redemption, downloads, telemetry and provider webhooks are separate and unchanged.
Request, response and error reference
Legacy operation. Use the current scoped APIs for new integrations.
No request body fields are read by this operation.
HTTP 410 response (application/json)
{
"type": "object",
"properties": {
"code": {
"const": "LEGACY_REDEMPTION_RETIRED"
},
"message": {
"type": "string"
},
"documentation": {
"const": "/docs/api/customer-library"
},
"replacement": {
"const": "/api/library/redeem-serial"
},
"accountUrl": {
"const": "/account#redeem-serial"
}
},
"additionalProperties": true,
"required": [
"code",
"message",
"documentation",
"replacement",
"accountUrl"
]
}
/api/redeem/redeem/complete
Retired legacy view; use the documented replacement
- Auth
- Public request; operation-specific verification still applies
- Scope
- Retired anonymous flow; no serial, customer, entitlement or account authorization is performed.
- Returns
- HTTP 410: retired compatibility response with code, documentation and replacement path; no records are returned.
- Side effects
- None; no data is queried, exported or changed.
- Notes
- Always returns 410 LEGACY_REDEMPTION_RETIRED before the old handler, including with a previously issued temp_token or download_token. Submitted identity, serial and token fields are ignored. No customer record, serial claim, entitlement, usage charge, email or token is created, changed or returned. Cache-Control is private, no-store. Sign in through /account#redeem-serial and use POST /api/library/redeem-serial with its current customer-account contract. Do not replay the old request body at another URL or treat a supplied email as proof of ownership. Current native /api/license/v1 claims, library redemption, downloads, telemetry and provider webhooks are separate and unchanged.
Request, response and error reference
Legacy operation. Use the current scoped APIs for new integrations.
No request body fields are read by this operation.
HTTP 410 response (application/json)
{
"type": "object",
"properties": {
"code": {
"const": "LEGACY_REDEMPTION_RETIRED"
},
"message": {
"type": "string"
},
"documentation": {
"const": "/docs/api/customer-library"
},
"replacement": {
"const": "/api/library/redeem-serial"
},
"accountUrl": {
"const": "/account#redeem-serial"
}
},
"additionalProperties": true,
"required": [
"code",
"message",
"documentation",
"replacement",
"accountUrl"
]
}
SoundSync
