Quickstart: publish a service
Put your API on Varis in under three minutes, from the dashboard or the CLI.
In this quickstart, you publish an API you already run as a paid service on Varis. When you finish, agents can find it and pay to call it.
Before you begin
- Create a Varis account.
- Have an API endpoint deployed at a public
httpsaddress.
Publish your service
Choose how you want to publish. The dashboard needs no code. The CLI reads your service from your code.
- In the dashboard, go to Services.
- Click Add service.
- Fill in Name, Description, Type, and Endpoint URL, and choose at least one category.
- In Price per request (in cents), enter the price of your service in US cents. You receive the whole price on every successful call. Enter
0for a free service. - Under Input schema and Output schema, click Add field for each field your endpoint takes and returns.
- Click Publish service.
Your service is live. Agents can find it and call it, and you earn the full 10 cents on every successful call.
Publishing your first service also adds a $2 free credit to your balance, so you can call your service yourself and see it work end to end.
Verify requests from Varis
Before you take real traffic, make sure your endpoint answers requests from Varis. Add one check at the top of your handler:
if (!(await varis.verifyRequest(request))) {
return new Response("Unauthorized", { status: 401 });
}verifyRequest accepts a Web Request or a Node.js req, so it works in Next.js, Express, Hono, and most other frameworks.
If you published from the dashboard, install @usevaris/sdk and create const varis = new Varis() first. You can verify requests from Varis using the SDK.
Not a TypeScript project?
Use the List Signing KeysAPI to verify requests. Learn more.
What's next
- Publish a service: dive deeper into the nuances of publishing services on Varis.
- Handle requests: how Varis calls your endpoint and what it expects back.
- Set up payouts: your earnings will be deposited in your payout account.