Test your API
Run a free test call to your upstream before launch, and read the result.
On this page
What a test call does
A test call sends one request to your upstream, with your stored key, using the same hardened HTTP client as the gateway. It's free: no quote, no payment, nothing on-chain. Its answer is judged by your API's billing rule. A test passes when your API answers 2xx in a way agents would be charged for.
A passing test is required before you can launch. Replacing or deleting the upstream key resets it, so run the test again after a key change.
Run a test
Choose the method
GET,POST,PUT,PATCHorDELETE.Enter a path
Under your upstream URL, with any query, for example
/forecast?city=Lisbon. Use a path that returns real data. It must start with a single/, can't contain#or.., and is at most 2,048 characters.Add a body (optional)
For methods other than
GET. Valid JSON is sent as JSON; anything else is sent as plain text.Choose Run test call
The result appears in the Test call panel.
Read the result
The panel shows the request, your upstream's status and response time, and either Test passed. Agents would be charged for this answer. or Test failed. with the reason. Below it, Response preview shows the first 1,024 characters of the answer, with your key removed.
| Failure | Meaning | Fix |
|---|---|---|
| That address isn't allowed | The upstream resolves to an address NODRA won't call. | Use a public https:// host. |
| Couldn't reach your API | DNS, TLS or connection failure. | Check the host is up and its certificate is valid. |
| Your API didn't answer in time | No complete answer within 10 seconds. | Test a faster path, or speed up the endpoint. Paid calls wait up to 20 seconds. |
| Your API answered with an error | A non-2xx status, a redirect, or an answer over 1 MiB. | On 401 or 403, check the key and its header. Redirects aren't followed: use the final URL. |
| The answer doesn't meet the billing rule | For example, a 2xx with an empty body. | Use a path that returns content. |
Limits
Test calls are rate limited per provider per minute. If you hit the limit, wait for the time given and try again.