---
title: "Query Workflow Variants"
method: GET
path: "/preview/base/workflows/variants/"
tags: ["Workflows"]
---

# Query Workflow Variants

`GET /preview/base/workflows/variants/`

## Query parameters

- `workflow_ref` string, nullable — JSON string of reference, e.g. {"key": value}
- `variant_ref` string, nullable — JSON string of reference, e.g. {"key": value}
- `variant_metadata` string, nullable — JSON string of metadata, e.g. {"key": value}
- `variant_flags` string, nullable — JSON string of flags, e.g. {"key": value}
- `include_archived` boolean, nullable

## Response `200`

Successful Response

- WorkflowVariantsResponse
  - `count` integer, required
  - `variants` WorkflowVariantOutput[]
    - `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
    - `slug` string, nullable
    - `id` string, uuid, nullable
    - `flags` WorkflowFlags
      - `is_custom` boolean, nullable
      - `is_evaluator` boolean, nullable
      - `is_human` boolean, nullable
    - `metadata` object, nullable
    - `artifact_id` string, uuid, nullable
    - `artifact` WorkflowArtifactOutput
      - `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
      - `slug` string, nullable
      - `id` string, uuid, nullable
      - `flags` WorkflowFlags
        - `is_custom` boolean, nullable
        - `is_evaluator` boolean, nullable
        - `is_human` boolean, nullable
      - `metadata` object, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2025-06-27** `e3e84db47198` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/preview/base/workflows/variants/get.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-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/e3e84db47198/schema)