---
title: "Get Versions"
method: GET
path: "/files/versions"
tags: ["files"]
---

# Get Versions

`GET /files/versions`

Get versions for a file. Accepts exactly one of either file_id or upload_id.
If upload_id is provided, it will be used to resolve the corresponding file_id.

## Query parameters

- `file_id` string, uuid, nullable
- `upload_id` string, uuid, nullable

## Response `200`

Successful Response

- StoredFile[]
  - `upload_id` string, uuid, required
  - `file_id` string, uuid, required
  - `filename` string, required
  - `created` string, date-time, required
  - `review_status` 'approved' | 'review_in_progress' | 'needs_remediation'
  - `aws_key` string, nullable
  - `vendor_id` string, uuid, nullable
  - `status` 'processing' | 'deleted' | 'in_use' | 'in_progress' | 'failed'
  - `collateral_type` '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'
  - `transcript_from_video` boolean, nullable
  - `preset_ids` string[], nullable
  - `failure_reason` string, nullable
  - `num_pages` integer, required
  - `file_type` string, required
  - `embed_state` 'COMPLETED' | 'IN_PROGRESS' | 'NOT_STARTED' | 'FAILED' | 'NOT_SUPPORTED' | 'CLEANUP_IN_PROGRESS'
  - `size_bytes` integer, nullable

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