Test instruction
POST/v2/instructions/:instruction_id/test
Tests an instruction template with supplied context and available tools. The endpoint evaluates Velocity expressions such as $tools, ${session.metadata.field}, or ${agent.metadata.field}, and returns the fully rendered template output. Use this operation to validate formatting, logic, or metadata-dependent behavior before you deploy instructions to agents.
Request
Responses
- 200
- 400
- 403
- 404
- 422
The rendered result of the instruction test.
Test request was malformed.
Permissions do not allow testing this instruction.
Instruction not found.
Template compilation failed due to invalid instruction template.