For the complete documentation index, see llms.txt. This page is also available as Markdown.

Sensorium

Per-source event health for the workspace (last 24h)

get
Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Responses
200

Successful Response

application/json
as_ofstring · date-timeRequired

Server clock at query time (UTC).

read_model_statusstring · enumRequired

ready = Lakebase projection returned rows; empty = no summary rows; unavailable = read failed.

Possible values:
read_model_synced_atstring · date-time · nullableOptional

Most recent platform.connector_health_summary synced_at value in this response.

get/v1/{workspace_id}/sensorium/connector-health
GET /v1/{workspace_id}/sensorium/connector-health HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

Successful Response

{
  "sources": [
    {
      "source": "text",
      "events_per_minute": 1,
      "events_last_hour": 1,
      "events_last_24h": 1,
      "last_ingested_at": "2026-01-01T00:00:00.000Z",
      "freshness": "fresh"
    }
  ],
  "as_of": "2026-01-01T00:00:00.000Z",
  "read_model_status": "ready",
  "read_model_synced_at": "2026-01-01T00:00:00.000Z"
}

Sense→act latency distribution for the workspace

get
Authorizations
AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters
workspace_idstring · uuidRequired
Query parameters
window_hoursinteger · min: 1 · max: 168Optional

Window size in hours (1-168).

Default: 24
Responses
200

Successful Response

application/json
as_ofstring · date-timeRequired

Server clock at query time (UTC).

window_hoursintegerRequired
overall_countintegerRequired

Total pairs across the window.

overall_p50_secondsnumber · nullableOptional

Median latency across the whole window; null if no pairs.

truncatedbooleanOptional

True when the underlying query hit the row cap; p50 is computed over the truncated sample.

Default: false
get/v1/{workspace_id}/sensorium/loop-latency
GET /v1/{workspace_id}/sensorium/loop-latency HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "as_of": "2026-01-01T00:00:00.000Z",
  "window_hours": 1,
  "overall_count": 1,
  "overall_p50_seconds": 1,
  "sparkline": [
    {
      "hour": "2026-01-01T00:00:00.000Z",
      "count": 1,
      "p50_seconds": 1
    }
  ],
  "truncated": false
}

Last updated

Was this helpful?