Skip to content

Docs / All tools / Loop IV: Validation

validation.run.status

Advance a validation run by one step and show what comes next.

Charged by the tools it calls. The step it runs is charged at the prices of the tools in that step. The call itself is free.

Example prompt

Send this to your AI app when Heelo is connected:

How far is my validation run? Show me the plan when it is ready.

Input fields

FieldTypeDescription
run_idstringLeave out to list your runs
answerstringYour user's answer to the assessment's question

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/validation.run.status/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {}},
    timeout=120,
)
response.raise_for_status()
print(response.json())