Quickstart

Make your first call in under 5 minutes. We'll summarise a short block of text and read back the structured intent.

1. Get an API key

API keys are issued per organisation. If you don't have one, email us and we'll provision one. Keys look like:

velgent_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Treat keys as secrets

Anyone with your key can call the API as your organisation. Store it in an environment variable or secret manager — never commit it to source control.

2. Make a request

3. Read the response

You'll get back a JSON object with the summary and an intent block:

{
  "id":      "sum_…",
  "summary": "- Q2 board pack is due Friday.\n- Finance must deliver the revenue cut by Wednesday.\n- Without it, there is no review time.",
  "intent": {
    "action_needed":  true,
    "due_date":       "2026-05-15",
    "urgency_score":  72,
    "sensitivity":    "medium"
  },
  "language":   "en",
  "usage":      { "input_tokens": 38, "output_tokens": 41, "total_tokens": 79 },
  "created_at": "2026-05-10T17:42:11Z"
}

Next steps

Authentication — how API keys and headers work in detail.
Operations — full reference for every endpoint.
Errors — every status code and what to do about it.
Rate limits — what to expect and how to back off.