#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. Sign in to admin.velgent.com, open API keys in the sidebar, give the key a name (e.g. production), and click Generate. The plaintext appears in a one-time reveal banner — copy it now or rotate later. Keys look like:

velgent_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

If your organisation hasn't been provisioned yet, email us — we'll send you a Magic Link invitation that signs you in and lands you on the admin console.

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. See Setting up API keys for rotation + revocation flow.

#2. Make a request

#3. Read the response

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

{
  "request_id":      "01HZQ7K8YV9X3R2M5N6P7QABCD",
  "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,
    "action_line":   "Push Finance to deliver the revenue cut by Wednesday.",
    "due_date":      "2026-05-15",
    "urgency_score": 8,
    "sensitivity":   "medium"
  },
  "format":          "bullets",
  "model_used":      "claude-sonnet-4-6",
  "redaction_count": 0,
  "latency_ms":      3712
}

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