Docs

Getting started

Make your first call

The platform exposes every capability over HTTPS at https://api.vagarylabs.com/product/v1, authenticated with an API key from your console.

Get a key. Create an account — you get an organization, a project, a production environment and a scoped key in one step. The key is shown once.
Check it works before writing any code. This endpoint needs no key and returns the live catalog of everything you can call:
```
curl https://api.vagarylabs.com/product/v1/_meta/catalog
```

Make an authenticated request. Send the key as a bearer token:

curl https://api.vagarylabs.com/product/v1/retrieval/search \
  -H "Authorization: Bearer $VAGARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "hello"}'

A key is scoped to the product you signed up for. Calling a capability it does not grant returns 403, not a silent empty result — you will know immediately which it is.

Keys are scoped and revocable per project. Rotate on suspicion; never ship a key in client-side code.

Read the capability guides for the services you plan to use.
Check the API reference for exact schemas and error codes.
See where the platform runs: the topology page.

Getting started

Make your first call

Next