IngestRequest

  • assets
    Type: array · IngestAssetInput[] 1…10000
    required
    • An ingest row: an AssetInput plus an optional per-row reviveArchived control flag.

      • identifier
        Type: string
        required
      • category
        Type: string
      • categoryType
        Type: string
      • chipModel
        Type: string

        CPU/chip model signal used to help infer vendor/category during normalize.

      • condition
        Type: string
      • conditionGrade
        Type: string
      • countryCode
        Type: string

        ISO country code (stored as country of origin).

      • locationName
        Type: string
      • manufacturer
        Type: string
      • memory
        Type: integer

        Integer numbers.

      • model
        Type: string
      • mpn
        Type: string
      • productNumber
        Type: string
      • quantity
        Type: integer

        Integer numbers.

      • reviveArchived
        Type: boolean

        Per-row override of the request-level reviveArchived. When this row's identifier matches a previously deleted (archived) asset, set true to restore it or false to skip it. Omit to inherit the request-level default.

      • serialNumber
        Type: string
      • sku
        Type: string
      • storageCapacity
        Type: string
      • storageType
        Type: string
      • type
        Type: string
      • vendor
        Type: string
      • weight
        Type: number
      • weightUnit
        Type: string
      • year
        Type: integer

        Integer numbers.

  • normalize
    Type: boolean

    Clean/enrich rows before upserting.

  • reviveArchived
    Type: boolean

    Request-level default for restoring deleted (archived) assets when their identifier is re-ingested. Defaults to false: an identifier that matches an archived asset is reported as an archived_conflict warning and left untouched (active assets still update normally). Set true to restore archived matches. A per-row reviveArchived on any asset overrides this default for that row. May also be supplied as a ?reviveArchived=true query param (if either is true, revival applies).

  • syncMode
    Type: stringenum

    DELTA upserts only sent rows; FULL may soft-retire assets absent from the batch.

    values
    • DELTA
    • FULL