Types & Ontology#

Types are git-branched, schema-as-code (ADR ontology). schema_alter evolves a type in place; ontology_migrate applies a SHACL constraint set; create_link/register_edge_type wire the graph. Modules group a type pack.

14 methods across this domain. Signatures, parameters (incl. keyword-only tunable defaults), and the three SDK spellings are ported from the live SDK source; flagship methods carry a hand-written When to use + example.

RelataClient#

register_type(name, **kwargs: object)#

When to use. Register a new governed type with its column schema and constraints.

• Python — client.relataclient.register_type(name, **kwargs: object)
• TypeScript — registerType(name, spec)
• Go — RegisterType(name, spec)

Parameters: name, **kwargs: object

Example

relata.register_type("Company", {"name": "string", "vat": "string?"}, pk="name")

schema_alter(type_name, action, column, new_column=None, col_type=None, optional=None)#

When to use. Evolve a type in place (add/drop columns) without a full re-register (ADR-1307).

• Python — client.relataclient.schema_alter(type_name, action, column, new_column=None, col_type=None, optional=None)
• TypeScript — schemaAlter(name, action, column, opts)
• Go — SchemaAlter(name, action, column)

Parameters: type_name, action, column, new_column=None, col_type=None, optional=None

Example

relata.schema_alter("Company", add={"lei": "string?"})

create_link(link_name, source_id, source_type, target_id, target_type)#

create_link(link_name, source_id, source_type, target_id, target_type)`

• Python — client.relataclient.create_link(link_name, source_id, source_type, target_id, target_type)
• TypeScript — createLink(params)
• Go — CreateLink(params)

Parameters: link_name, source_id, source_type, target_id, target_type

delete_webhook(webhook_id)#

delete_webhook(webhook_id)`

• Python — client.relataclient.delete_webhook(webhook_id)
• TypeScript — deleteWebhook(id)
• Go — DeleteWebhook(id)

Parameters: webhook_id

deregister_type(name)#

deregister_type(name)`

• Python — client.relataclient.deregister_type(name)
• TypeScript — deregisterType(name)
• Go — DeregisterType(name)

Parameters: name

enrichment_rules(rules)#

enrichment_rules(rules)`

• Python — client.relataclient.enrichment_rules(rules)
• TypeScript — enrichmentRules(rules)
• Go — EnrichmentRules(rules)

Parameters: rules

list_edge_types()#

list_edge_types()`

• Python — client.relataclient.list_edge_types()
• TypeScript — listEdgeTypes()
• Go — ListEdgeTypes()

list_modules()#

list_modules()`

• Python — client.relataclient.list_modules()
• TypeScript — listModules()
• Go — ListModules()

list_types()#

list_types()`

• Python — client.relataclient.list_types()
• TypeScript — listTypes()
• Go — ListTypes()

list_webhooks()#

list_webhooks()`

• Python — client.relataclient.list_webhooks()
• TypeScript — listWebhooks()
• Go — ListWebhooks()

ontology_migrate(schema)#

ontology_migrate(schema)`

• Python — client.relataclient.ontology_migrate(schema)
• TypeScript — ontologyMigrate(schema)
• Go — OntologyMigrate(schema)

Parameters: schema

register_edge_type(from_type, to_type, label)#

register_edge_type(from_type, to_type, label)`

• Python — client.relataclient.register_edge_type(from_type, to_type, label)
• TypeScript — registerEdgeType(fromType, toType, label)
• Go — RegisterEdgeType(fromType, toType, label)

Parameters: from_type, to_type, label

register_webhook(url, event_types=None)#

register_webhook(url, event_types=None)`

• Python — client.relataclient.register_webhook(url, event_types=None)
• TypeScript — registerWebhook(url, eventTypes)
• Go — RegisterWebhook(url, eventTypes)

Parameters: url, event_types=None

type_detail(name)#

type_detail(name)`

• Python — client.relataclient.type_detail(name)
• TypeScript — typeDetail(name)
• Go — TypeDetail(name)

Parameters: name