v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB

tools

Preview a revision's RAW response + narrowed field map (no persist)

Run a revision's HTTP config and return the RAW body + a narrowed preview.

Powers the dashboard field-map editor (ENG-631). Unlike /execute (which runs the active revision and narrows by its saved map), this runs the given revision with no narrowing so the raw side is always raw, then computes narrowed from the effective field map (request override → the revision's saved response_schema → none). Verifies the revision belongs to the caller's org AND to tool_id (404 otherwise). Persists nothing.

post/v1/tools/{tool_id}/revisions/{revision_id}/test

Path parameters

tool_idstring uuid required

revision_idstring uuid required

Request body

inputobject

metadataobject

Response

Successful Response

status_codeinteger required

headersobject

{"stackTrail":"components:schemas:ToolRevisionTestResponse:properties:body","oasType":"schema","type":"unknown","title":"Body"}

{"stackTrail":"components:schemas:ToolRevisionTestResponse:properties:narrowed:anyOf","oasType":"schema","type":"unknown","title":"Narrowed","nullable":true}

successboolean

errorstring nullable

execution_time_msnumber nullable

request_urlstring nullable

request_methodstring nullable