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

# Find Collateral Version Matches

`POST /marketing/collateral/version-matches`

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/marketing/collateral/version-matches`
- Auth: none declared

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/kobaltlabs-api.md) - [All operations](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/revisions/8587332d5e43?raw)