---
title: "Run a workflow as a test"
method: POST
path: "/hub/workflows/run-test"
tags: ["Workflows"]
---

# Run a workflow as a test

`POST /hub/workflows/run-test`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/hub/workflows/run-test`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/docs/hub/workflows/run-test/post.ts> (a function with typed inputs; its response is checked against the schema)

Runs a workflow in test mode and answers with the run detail.

## Request body

- object

## Response `200`

Success

- object

## Other responses

- `400`: Request refused or invalid

## Changes

- **2026-11-12** `8730377687f9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/changes/hub/workflows/run-test/post.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/revisions/f80cd5f3ac1c?raw)