PRpromptlayer
tool-registry

Test Execute Tool

Changed on
post/api/public/v2/tool-registry/{identifier}/test-execute

Request

Path parameters

identifierstring required

Tool ID (numeric) or name

Query parameters

labelstring

Resolve version by label name (e.g. production). Falls back to latest if neither label nor version supplied.

versionstring

Resolve by specific version number

Headers

X-API-KEYstring required

Request body

inputsobject

Arguments passed to the tool body. Same shape the LLM would emit — keys match the tool's parameter names.

tool_definitionobject nullable

In-flight override of the stored tool definition. Used to test against a different function name without saving.

Response

Tool executed (success or user-code error). User-code errors return status="error" inside the result object — they do NOT raise.

successboolean
messagestring

Changes