---
search:
  tags:
    - Agents
    - POST
seo:
  description: >-
    Run an agent against a single sample record without deploying to Flink.
    Reference for the POST /agents/test-run endpoint in the Streamkap REST API.
sidebar:
  label: Test Run Agent
  badge: POST
title: Test Run Agent
type: openapi-operation
---
Run an agent against a single sample record without deploying to Flink.

Synchronous, hard-capped at 15s wall-clock. Calls the LLM provider
directly + dispatches MCP and HTTP tools live; transform tools and
memory are intentionally not exercised (the Flink runtime owns
them). Per-tenant rate limit: shares the validate-llm bucket
(30 req/min/tenant) -> 429.

Provider failures (timeouts, schema errors, unsupported provider) land
as a structured ``error`` object on the envelope (HTTP still 200) so
the FE can render the partial timeline alongside the error context.
Only the input-token cap raises (422) - at that point we can't even
start the run.

`POST /agents/test-run`