API Reference

The Loomkindle REST API lets you manage pipelines, query metrics, introspect schemas, and receive change notifications via webhooks.

Base URL https://api.loomkindle.com/v1

Authentication

All API requests require a bearer token. Generate tokens from your workspace settings under API Tokens.

HTTP Header

Authorization: Bearer lmk_sk_your_token_here

Pipelines

GET /pipelines

List all pipelines in your workspace.

Response 200

{
  "pipelines": [
    {
      "id": "pipe_abc123",
      "name": "orders-to-warehouse",
      "status": "active",
      "last_run": "2026-04-20T14:30:00Z"
    }
  ]
}

POST /pipelines/{id}/run

Trigger a manual pipeline run.

Metrics

GET /metrics

List all registered semantic metrics.

POST /metrics/query

Query a metric with optional filters and group-bys.

Request body

{
  "metric": "total_revenue",
  "group_by": ["region"],
  "filters": [
    {"dimension": "date", "operator": "gte", "value": "2026-01-01"}
  ]
}

Schema Introspection

GET /schema/diff

Get the latest schema drift report — columns added, removed, or type-changed since last sync.

Webhooks

Loomkindle sends webhook events for pipeline completions, schema drift detections, and agentic rerouting decisions. Configure endpoints in workspace settings.

Event	Payload
`pipeline.run.complete`	Pipeline ID, status, row count, duration
`schema.drift.detected`	Source, affected columns, severity
`pipeline.rerouted`	Old route, new route, trigger reason