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

# Upload Collateral Version

`POST /marketing/collateral/version`

## 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`
- Auth: none declared

Upload a new version of a marketing collateral file.

The security boundary for versioning: `file_id` is chosen client-side, so
this authorizes on the same predicate that decided what to suggest, and an
out-of-scope file is a 404, not a 403 — no probing for other scopes.

## Request body `multipart/form-data`

- BodyUploadCollateralVersionMarketingCollateralVersionPost
  - `file` string, binary, required
  - `file_id` string, uuid, required
  - `collateral_type` union
    - 'Agent Call Flow' | 'Audio' | 'Billboard' | 'Communications' | 'Conversation Design' | 'Email' | 'Help Center Article' | 'In-App' | 'Mailer' | 'Organic Social' | 'Paid Advertising' | 'Paid Search' | 'Paid Social' | 'Press Release' | 'Procedure/Decision Tree' | 'Support Agent Training' | 'TV' | 'Web' | 'Wiki' | 'Other'
    - ''
  - `vendor_id` string, uuid, nullable

## Response `200`

Successful Response

- FileUploadResult
  - `file_id` string, uuid, required
  - `upload_id` string, uuid, required

## 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)