World

List entity types

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/entity-types

Returns distinct entity types in the workspace with counts and projection availability. Powers the World Explorer's auto-discovery of new entity types created by agents (L4 self-extending schema).

Authorizations

BearerAuth

AuthorizationstringRequired

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

Responses

200

Successful Response

application/json

total_entitiesintegerRequired

401

Missing or invalid API key.

get

/v1/{workspace_id}/world/entity-types

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/entity-types HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "entity_types": [
    {
      "entity_type": "text",
      "count": 1,
      "last_updated": "2026-03-22T05:27:56.772Z",
      "has_projection": true
    }
  ],
  "total_entities": 1
}

List event types

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/event-types

Returns distinct event types in the workspace with counts, domains, and source breakdown. Enables the World Explorer to show what kinds of events flow through the world model.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Responses

200

Successful Response

application/json

total_eventsintegerRequired

401

Missing or invalid API key.

get

/v1/{workspace_id}/world/event-types

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/event-types HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "event_types": [
    {
      "event_type": "text",
      "count": 1,
      "domains": [
        "text"
      ],
      "sources": [
        "text"
      ]
    }
  ],
  "total_events": 1
}

Entity stats with sync breakdown

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/entity-stats

Aggregate stats for entities including sync status breakdown (pending, synced, failed). Filter by entity_type to get stats for a specific type (e.g. appointment, patient). Generic — works for any entity type in the Liquid World Model.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Query parameters

entity_typeany ofOptional

Filter by entity type

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

total_entitiesintegerRequired

total_eventsintegerRequired

sync_pendingintegerRequired

sync_syncedintegerRequired

sync_failedintegerRequired

401

Missing or invalid API key.

422

Validation Error

application/json

get

/v1/{workspace_id}/world/entity-stats

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/entity-stats HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "total_entities": 1,
  "total_events": 1,
  "sync_pending": 1,
  "sync_synced": 1,
  "sync_failed": 1,
  "by_event_type": {
    "ANY_ADDITIONAL_PROPERTY": 1
  }
}

List sync events by status

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/sync/events

Lists outbound events filtered by sync status (pending or failed). Includes entity display_name for the UI. Use for the pending events table (status=pending) or the retry table (status=failed).

Authorizations

BearerAuth

AuthorizationstringRequired

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

Query parameters

statusstring · enumRequiredPossible values:

limitinteger · min: 1 · max: 200OptionalDefault: 50

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

totalintegerRequired

has_morebooleanRequired

next_offsetany ofOptional

integerOptional

or

nullOptional

400

Invalid status parameter.

401

Missing or invalid API key.

422

Validation Error

application/json

get

/v1/{workspace_id}/world/sync/events

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/sync/events?status=pending HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "events": [
    {
      "event_id": "123e4567-e89b-12d3-a456-426614174000",
      "entity_id": "123e4567-e89b-12d3-a456-426614174000",
      "entity_type": "text",
      "event_type": "text",
      "fhir_resource_type": "text",
      "fhir_resource_id": "text",
      "source": "text",
      "sync_status": "text",
      "sync_error": "text",
      "synced_at": "2026-03-22T05:27:56.772Z",
      "created_at": "2026-03-22T05:27:56.772Z",
      "display_name": "text"
    }
  ],
  "total": 1,
  "has_more": true,
  "next_offset": 1
}

Outbound sync queue depth

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/sync/queue

Pending and failed outbound sync event counts, grouped by FHIR resource type. Includes oldest pending timestamp and last successful sync time. Queries Lakebase — not Valkey.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Responses

200

Successful Response

application/json

pending_countintegerRequired

failed_countintegerRequired

oldest_pending_atany ofOptional

string · date-timeOptional

or

nullOptional

last_sync_success_atany ofOptional

string · date-timeOptional

or

nullOptional

401

Missing or invalid API key.

get

/v1/{workspace_id}/world/sync/queue

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/sync/queue HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "pending_count": 1,
  "failed_count": 1,
  "oldest_pending_at": "2026-03-22T05:27:56.772Z",
  "last_sync_success_at": "2026-03-22T05:27:56.772Z",
  "by_resource_type": {
    "ANY_ADDITIONAL_PROPERTY": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  }
}

Retry a failed sync event

post

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/sync/retry/{event_id}

Clears sync_error on a failed event and re-publishes to the outbound sync channel. The event re-enters the sync pipeline.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Path parameters

event_idstringRequired

Responses

200

Successful Response

application/json

event_idstringRequired

statusstringRequired

400

Invalid event ID format.

401

Missing or invalid API key.

404

Event not found or has no sync_error.

422

Event missing FHIR resource type/ID.

post

/v1/{workspace_id}/world/sync/retry/{event_id}

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/world/sync/retry/{event_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "event_id": "text",
  "status": "text"
}

Retry all failed sync events

post

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/sync/retry-all

Clears sync_error on all failed events in the workspace and re-publishes each to the outbound sync channel.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Responses

200

Successful Response

application/json

retriedintegerRequired

failed_to_publishintegerRequired

401

Missing or invalid API key.

post

/v1/{workspace_id}/world/sync/retry-all

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/world/sync/retry-all HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "retried": 1,
  "failed_to_publish": 1
}

List entities

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/entities

List entities filtered by type with optional name search. Works for any entity type — patients, operators, calls, or any type created by T3 agents. Returns full projected state.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Query parameters

entity_typeany ofOptional

Filter by entity type

stringOptional

or

nullOptional

qany ofOptional

Search by display name

stringOptional

or

nullOptional

limitinteger · min: 1 · max: 100OptionalDefault: 20

offsetintegerOptionalDefault: 0

has_projectionany ofOptional

Filter by has_projection flag

booleanOptional

or

nullOptional

Responses

200

Successful Response

application/json

totalintegerRequired

has_morebooleanRequired

next_offsetany ofOptional

integerOptional

or

nullOptional

401

Missing or invalid API key.

422

Validation Error

application/json

get

/v1/{workspace_id}/world/entities

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/entities HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "entities": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "entity_type": "text",
      "display_name": "text",
      "canonical_id": "text",
      "external_ids": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "state": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "has_projection": false,
      "first_seen_at": "2026-03-22T05:27:56.772Z",
      "last_event_at": "2026-03-22T05:27:56.772Z",
      "event_count": 0,
      "confidence": 1,
      "tags": [
        "text"
      ],
      "created_at": "2026-03-22T05:27:56.772Z",
      "updated_at": "2026-03-22T05:27:56.772Z"
    }
  ],
  "total": 1,
  "has_more": true,
  "next_offset": 1
}

Get entity

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/entities/{entity_id}

Fetch a single entity with its full projected state. The state is a computed projection from all events — never mutated directly. Enhanced entity types (patient, operator, call) have richer projections.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Path parameters

entity_idstringRequired

Responses

200

Successful Response

application/json

idstring · uuidRequired

workspace_idstring · uuidRequired

entity_typestringRequired

display_nameany ofOptional

stringOptional

or

nullOptional

canonical_idany ofOptional

stringOptional

or

nullOptional

has_projectionbooleanOptionalDefault: false

first_seen_atany ofOptional

string · date-timeOptional

or

nullOptional

last_event_atany ofOptional

string · date-timeOptional

or

nullOptional

event_countintegerOptionalDefault: 0

confidencenumberOptionalDefault: 1

tagsany ofOptional

string[]Optional

or

nullOptional

created_atany ofOptional

string · date-timeOptional

or

nullOptional

updated_atany ofOptional

string · date-timeOptional

or

nullOptional

400

Invalid entity ID format.

401

Missing or invalid API key.

404

Entity not found.

422

Validation Error

application/json

get

/v1/{workspace_id}/world/entities/{entity_id}

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/entities/{entity_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "entity_type": "text",
  "display_name": "text",
  "canonical_id": "text",
  "external_ids": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "state": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "has_projection": false,
  "first_seen_at": "2026-03-22T05:27:56.772Z",
  "last_event_at": "2026-03-22T05:27:56.772Z",
  "event_count": 0,
  "confidence": 1,
  "tags": [
    "text"
  ],
  "created_at": "2026-03-22T05:27:56.772Z",
  "updated_at": "2026-03-22T05:27:56.772Z"
}

Entity timeline

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/entities/{entity_id}/timeline

Get the event timeline for an entity — all current events ordered by effective date. The entity's state is always a projection of these events. Filter by domain (clinical, operational, audit, etc.).

Authorizations

BearerAuth

AuthorizationstringRequired

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

Path parameters

entity_idstringRequired

Query parameters

domainany ofOptional

Filter by domain

stringOptional

or

nullOptional

limitinteger · min: 1 · max: 200OptionalDefault: 50

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

entity_idstring · uuidRequired

totalintegerRequired

has_morebooleanRequired

next_offsetany ofOptional

integerOptional

or

nullOptional

400

Invalid entity ID format.

401

Missing or invalid API key.

404

Entity not found.

422

Validation Error

application/json

get

/v1/{workspace_id}/world/entities/{entity_id}/timeline

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/entities/{entity_id}/timeline HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "entity_id": "123e4567-e89b-12d3-a456-426614174000",
  "events": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "domain": "text",
      "entity_type": "text",
      "event_type": "text",
      "event_subtype": "text",
      "fhir_resource_type": "text",
      "fhir_resource_id": "text",
      "data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "source": "manual",
      "source_system": "text",
      "confidence": 1,
      "produced_by_agent": "text",
      "supersedes": "123e4567-e89b-12d3-a456-426614174000",
      "is_current": true,
      "effective_at": "2026-03-22T05:27:56.772Z",
      "ingested_at": "2026-03-22T05:27:56.772Z",
      "synced_at": "2026-03-22T05:27:56.772Z",
      "sync_error": "text",
      "sync_status": "text",
      "created_at": "2026-03-22T05:27:56.772Z"
    }
  ],
  "total": 1,
  "has_more": true,
  "next_offset": 1
}

Entity relationships

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/world/entities/{entity_id}/relationships

Get relationships for an entity — links to other entities in the knowledge graph. Filter by relationship type.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Path parameters

entity_idstringRequired

Query parameters

relationshipany ofOptional

Filter by relationship type

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

entity_idstring · uuidRequired

totalintegerRequired

400

Invalid entity ID format.

401

Missing or invalid API key.

404

Entity not found.

422

Validation Error

application/json

get

/v1/{workspace_id}/world/entities/{entity_id}/relationships

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/world/entities/{entity_id}/relationships HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "entity_id": "123e4567-e89b-12d3-a456-426614174000",
  "relationships": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "source_entity_id": "123e4567-e89b-12d3-a456-426614174000",
      "source_entity_type": "text",
      "target_entity_id": "123e4567-e89b-12d3-a456-426614174000",
      "target_entity_type": "text",
      "relationship": "text",
      "data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "confidence": 1,
      "discovered_by": "text",
      "is_current": true,
      "created_at": "2026-03-22T05:27:56.772Z"
    }
  ],
  "total": 1
}