---
title: "Create Testset Revision From File"
method: POST
path: "/testsets/revisions/{testset_revision_id}/upload"
tags: ["Testsets"]
---

# Create Testset Revision From File

`POST /testsets/revisions/{testset_revision_id}/upload`

## Request

- Base URL: `https://cloud.agenta.ai/api`
- URL: `https://cloud.agenta.ai/api/testsets/revisions/{testset_revision_id}/upload`
- Auth: API key in header `Authorization`

## Path parameters

- `testset_revision_id` string, uuid, required

## Request body `multipart/form-data`

- BodyCreateTestsetRevisionFromFile
  - `file` string, binary, required
  - `file_type` 'csv' | 'json'
  - `include_testcases` boolean, nullable

## Response `200`

Successful Response

- TestsetRevisionResponse
  - `count` integer
  - `testset_revision` TestsetRevision
    - `testset_variant_id` string, uuid, nullable
    - `variant_id` string, uuid, nullable
    - `testset_id` string, uuid, nullable
    - `artifact_id` string, uuid, nullable
    - `author` string, uuid, nullable
    - `date` string, date-time, nullable
    - `message` string, nullable
    - `flags` TestsetFlags: Placeholder for testset-level flags. This model is intentionally empty but kept as a dedicated type so that: - existing references to `flags: Optional[TestsetFlags]` remain valid, and - structured flags can be added here in the future without breaking the surrounding DTOs.
    - `tags` object, nullable
    - `meta` object, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
    - `created_by_id` string, uuid, nullable
    - `updated_by_id` string, uuid, nullable
    - `deleted_by_id` string, uuid, nullable
    - `version` string, nullable
    - `slug` string, nullable
    - `id` string, uuid, nullable
    - `data` TestsetRevisionDataOutput
      - `testcase_ids` string[], nullable
      - `testcases` TestcaseOutput[], nullable
        - `testset_id` string, uuid, nullable
        - `set_id` string, uuid, nullable
        - `created_at` string, date-time, nullable
        - `updated_at` string, date-time, nullable
        - `deleted_at` string, date-time, nullable
        - `created_by_id` string, uuid, nullable
        - `updated_by_id` string, uuid, nullable
        - `deleted_by_id` string, uuid, nullable
        - `id` string, uuid, nullable
        - `flags` object, nullable
        - `tags` object, nullable
        - `meta` object, nullable
        - `data` object, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-03-07** `20311f763505`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/testsets/revisions/:testset_revision_id/upload/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) - [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agenta-ai/apis/agenta-api/revisions/20311f763505?raw)