Public API Surface

Lavoval API

A minimal public gateway for health, readiness, and versioned application routes. Built for operators, integrations, and quick verification.

Health Ready

Service

Lavoval

Environment

production

Health Endpoint

Checking…

API V1

v1

Usage

Use /healthz for effective runtime configuration flags, /readyz for readiness, /livez for heartbeat checks, and /api/v1/* for the versioned application surface.

GET /livez Simple heartbeat for liveness probes.
GET /healthz Safe runtime flags for env and provider health.
GET /readyz Readiness signal for traffic acceptance.
Endpoint Index JSON
{
  "api": {
    "base": "/api/v1",
    "namespaces": [
      "/api/v1/auth",
      "/api/v1/skills",
      "/api/v1/me",
      "/api/v1/runtime",
      "/api/v1/admin"
    ]
  },
  "env": "production",
  "routes": {
    "healthz": "/healthz",
    "livez": "/livez",
    "readyz": "/readyz"
  },
  "service": "Lavoval"
}

Authentication

/api/v1/auth

Registration, login, OAuth start and complete flows, email verification, password reset, and MFA enrollment and sign-in completion.

Public skills

/api/v1/skills

Public catalog listing and skill detail routes for published marketplace offers.

Account

/api/v1/me

Authenticated profile, security settings, and creator-owned skill management.

Runtime

/api/v1/runtime

Skill execution endpoints for starting runs and inspecting run history.

Admin

/api/v1/admin

Governance, moderation, mail operations, runtime oversight, and internal operational tooling.

Quick start

Start with the health surfaces, then move into the versioned API. For authenticated routes, send a bearer token after completing the auth flow under /api/v1/auth.

Health
curl https://api.lavoval.com/healthz
Public catalog
curl https://api.lavoval.com/api/v1/skills
Authenticated request
curl https://api.lavoval.com/api/v1/me \
  -H "Authorization: Bearer <access-token>"