---
title: "Find Collateral Version Matches"
method: POST
path: "/marketing/collateral/version-matches"
tags: ["marketing-collateral"]
---

# Find Collateral Version Matches

`POST /marketing/collateral/version-matches`

Existing collateral that the about-to-be-uploaded files look like
versions of. Read-only; scoping here is a UX filter — `POST /version` is
what enforces the boundary.

## Request body

- CollateralVersionMatchRequest
  - `files` DroppedFileFingerprint[], required
    - `key` string, required
    - `filename` string, required
    - `content_hash` string, nullable
  - `vendor_id` string, uuid, nullable
  - `marketing_team_id` string, uuid, nullable

## Response `200`

Successful Response

- CollateralVersionMatchResponse
  - `matches` CollateralVersionMatch[], required
    - `key` string, required
    - `match_type` 'identical' | 'similar', required
    - `file_id` string, uuid, required
    - `matched_filename` string, required
    - `last_analyzed_date` string, date-time, nullable
    - `reason` string, nullable
    - `preset_ids` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kobaltlabs/apis/fastapi.md) · [All operations](https://skmtc.dev/kobaltlabs/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kobaltlabs/fastapi/revisions/425d5b8a3c17/schema)