Skip to content
Sign in
Menu

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

  1. Choose the method

    GET, POST, PUT, PATCH or DELETE.

  2. 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.

  3. Add a body (optional)

    For methods other than GET. Valid JSON is sent as JSON; anything else is sent as plain text.

  4. 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.

FailureMeaningFix
That address isn't allowedThe upstream resolves to an address NODRA won't call.Use a public https:// host.
Couldn't reach your APIDNS, TLS or connection failure.Check the host is up and its certificate is valid.
Your API didn't answer in timeNo 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 errorA 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 ruleFor 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.