Build with your agents.

export AGENT_API_BASE='<website HTTPS origin>/api'
export AGENT_API_KEY='<your saved secret>'
export AGENT_VERSION_ID='<version ID from the agent API tab>'
export REQUEST_ID="$(node -e 'console.log(crypto.randomUUID())')"

curl "$AGENT_API_BASE/v1/runs" \
  -H "Authorization: Bearer $AGENT_API_KEY" \
  -H "Idempotency-Key: $REQUEST_ID" \
  -H "Content-Type: application/json" \
  --data "{\"versionId\":\"$AGENT_VERSION_ID\",\"input\":\"What can you help me with?\"}"

# Set RUN_ID to the id returned above.
curl "$AGENT_API_BASE/v1/runs/$RUN_ID" \
  -H "Authorization: Bearer $AGENT_API_KEY"

const base = process.env.AGENT_API_BASE ?? '<website HTTPS origin>/api';
const headers = {
  Authorization: 'Bearer ' + process.env.AGENT_API_KEY,
  'Content-Type': 'application/json',
};
// Persist this ID with your job; reuse it for a retry of this same input.
const requestId = crypto.randomUUID();
const response = await fetch(base + '/v1/runs', {
  method: 'POST',
  headers: { ...headers, 'Idempotency-Key': requestId },
  body: JSON.stringify({
    versionId: process.env.AGENT_VERSION_ID,
    budgetId: process.env.AGENT_BUDGET_ID || undefined, // Optional paid fallback
    input: 'What can you help me with?',
  }),
});
let run = await response.json();
if (!response.ok) throw new Error(run.error?.message);
const deadline = Date.now() + 12 * 60_000;
while (!['succeeded', 'failed', 'cancelled', 'unknown'].includes(run.execution)) {
  if (Date.now() > deadline) throw new Error('Resume polling run ' + run.id);
  await new Promise(resolve => setTimeout(resolve, 2000));
  const poll = await fetch(base + '/v1/runs/' + run.id, { headers });
  const result = await poll.json();
  if (!poll.ok) throw new Error(result.error?.message);
  run = result;
}
console.log({ id: run.id, execution: run.execution,
  funding: run.funding, answer: run.output?.text, error: run.error });
// The answer is ready when execution succeeds, even if funding is pending.
// Save run.id. Fetch this same receipt later for final payment status;
// the server continues settlement without this client staying connected.