Aliases

List schema graph aliases: mappings from raw extracted field names to their canonical field names within a schema class, produced during field resolution.

A schema alias maps a raw extracted field name to the canonical field name it resolves to within a schema class. Documents label the same concept many ways ("Invoice No.", "Inv #", "Rechnungsnummer"); field resolution clusters those variants onto one canonical field, and each variant is recorded as an alias row. This endpoint lists all alias mappings for your organization, newest first.

Aliases are populated automatically from the field-resolution clusters: when a raw field name is bound to a canonical registry concept, an alias row links alias_name to canonical_name (and to the canonical field's registry UUID). Use the list to audit how variant labels resolve, to debug why two spellings of a field ended up on the same column, or to export a normalization dictionary for your own tooling.

Response

{
  "data": [
    {
      "id": "alias-uuid-1",
      "customer_id": "org-uuid",
      "schema_class_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "alias_name": "Inv #",
      "canonical_name": "invoice_number",
      "canonical_field_id": "field-uuid-1",
      "source": "resolution",
      "created_at": "2024-08-20T00:00:00.000Z"
    }
  ]
}

Errors