PRprewave
Collections - Tier-N

Update tier-n collection settings

Changed on

Overview

Update tier-n configuration for a collection. All request fields are optional (partial update). Updated settings become defaults for GET .../tier-n/data.

Validation

  • Collection must exist, be active, and have tiersEnabled=true.
  • maxTier 1–9 if provided; probability 0–100 if provided; dates in YYYY-MM-DD; shipmentsPeriodFrom ≤ shipmentsPeriodTo.

Audit

The update is recorded with comment "Tier-n collection settings updated via Public API".

Required Permission

manage_collection and update on the collection.

put/public/v1/collections/{collectionId}/tier-n/settings

Request

Path parameters

collectionIdinteger required

Unique identifier of the tier-n collection. Same as the id from GET /public/v1/collections. The collection must have tiersEnabled=true.

Request body

maxTierinteger nullable

Maximum tier level configured for analysis. Range: 1-9. Higher values allow deeper supply chain analysis but may increase response time.

scopePrivateboolean nullable

Whether to include private targets in the analysis scope. Private targets typically represent internal company data.

scopeSharedboolean nullable

Whether to include shared targets in the analysis scope. Shared targets typically represent partner/team data.

scopePublicboolean nullable

Whether to include public targets in the analysis scope. Public targets typically represent open/public data.

sourceCustomerboolean nullable

Whether to include customer data sources in the analysis. Customer data comes from customer-provided information.

sourceCustomsboolean nullable

Whether to include customs data sources in the analysis. Customs data is typically the most reliable source based on shipment records.

sourceMediaboolean nullable

Whether to include media data sources in the analysis. Media data comes from news reports and may be less reliable.

sourcePrewavePredictionboolean nullable

Whether to include Prewave prediction data sources in the analysis. These are AI-predicted relationships with confidence scores.

minShipmentsinteger nullable

Minimum number of shipments required for a relationship to be included. Higher values filter out less established relationships. Set to null to remove minimum.

probabilityinteger nullable

Minimum probability threshold for predicted relationships (0-100). Higher values return only high-confidence predictions. Set to null to remove threshold.

shipmentsPeriodFromstring date nullable

Start date for shipment period analysis. Only relationships with shipments in this period are considered. Format: YYYY-MM-DD. Set to null to remove start date limit.

shipmentsPeriodTostring date nullable

End date for shipment period analysis. Only relationships with shipments in this period are considered. Format: YYYY-MM-DD. Set to null to remove end date limit.

suspectedSuppliersboolean nullable

Deprecated. Whether to include suspected suppliers. Ignored, and suspected suppliers are always turned off, when the new commodity filter is enabled for your organization, which will become the default for all organizations.

logisticsProviderboolean nullable

Whether to include logistics providers in the analysis. Logistics providers are companies that provide logistics services rather than direct suppliers.

Example request

{
  "maxTier": 3,
  "scopePrivate": true,
  "scopeShared": true,
  "sourceCustomer": true,
  "sourceCustoms": true,
  "sourcePrewavePrediction": true,
  "minShipments": 5,
  "probability": 75,
  "shipmentsPeriodFrom": "2024-01-01",
  "shipmentsPeriodTo": "2024-12-31"
}

Response

Tier-n collection settings updated successfully.

collectionIdinteger required

Unique identifier of the collection. Use this ID in API requests to reference this specific collection.

collectionNamestring required

Human-readable name of the collection. Useful for display purposes and identifying the collection in logs.

maxTierinteger required

Maximum tier level configured for analysis. Range: 1-9. Higher values allow deeper supply chain analysis but may increase response time.

targetIdsinteger[] required

List of target IDs included in this collection. These are the starting points for tier-n analysis.

scopePrivateboolean required

Whether to include private targets in the analysis scope. Private targets typically represent internal company data.

scopeSharedboolean required

Whether to include shared targets in the analysis scope. Shared targets typically represent partner/team data.

scopePublicboolean required

Whether to include public targets in the analysis scope. Public targets typically represent open/public data.

sourceCustomerboolean required

Whether to include customer data sources in the analysis. Customer data comes from customer-provided information.

sourceCustomsboolean required

Whether to include customs data sources in the analysis. Customs data is typically the most reliable source based on shipment records.

sourceMediaboolean required

Whether to include media data sources in the analysis. Media data comes from news reports and may be less reliable.

sourcePrewavePredictionboolean required

Whether to include Prewave prediction data sources in the analysis. These are AI-predicted relationships with confidence scores.

minShipmentsinteger nullable

Minimum number of shipments required for a relationship to be included. Higher values filter out less established relationships. Null means no minimum.

probabilityinteger nullable

Minimum probability threshold for predicted relationships (0-100). Higher values return only high-confidence predictions. Null means no threshold.

shipmentsPeriodFromstring date nullable

Start date for shipment period analysis. Only relationships with shipments in this period are considered. Format: YYYY-MM-DD. Null means no start date limit.

shipmentsPeriodTostring date nullable

End date for shipment period analysis. Only relationships with shipments in this period are considered. Format: YYYY-MM-DD. Null means no end date limit.

suspectedSuppliersboolean required

Deprecated. Whether suspected suppliers are included. Always false when the new commodity filter is enabled for your organization, which will become the default for all organizations.

logisticsProviderboolean required

Whether to include logistics providers in the analysis. Logistics providers are companies that provide logistics services rather than direct suppliers.

commodityFilterTargetIdsinteger[] required

List of target IDs used for commodity-based filtering. These targets help focus the analysis on specific commodity categories.

Example response

{
  "collectionId": 123,
  "collectionName": "My Tier-N Collection",
  "maxTier": 3,
  "targetIds": [
    101,
    102,
    103
  ],
  "scopePrivate": true,
  "scopeShared": true,
  "sourceCustomer": true,
  "sourceCustoms": true,
  "sourcePrewavePrediction": true,
  "minShipments": 5,
  "probability": 75,
  "shipmentsPeriodFrom": "2024-01-01",
  "shipmentsPeriodTo": "2024-12-31",
  "commodityFilterTargetIds": [
    201,
    202
  ]
}

Changes

  • ecd3f30c3c00Revision changes
    • info

      request property deprecated

    • info

      response property suspectedSuppliers deprecated