Create Datamap

Creates a new Datamap in Promethium based on a SQL definition and optional metadata. Datamaps can be virtualized as views or materialized as physical tables.

---

Endpoint

POST https://api.prod.promethium.ai/datamap/create

Headers

Header Name	Value	Required	Description
Content-Type	application/json	✅	Specifies the format of the request body
idtoken	<authentication_id_token>	✅	Bearer token obtained via authenticated login

Request Body

{
 "name": str,
 "description": "str",
 "tags": str[],
 "owner": str,
 "sme": str,
 "requestor": str,
 "custom_attr": {
 "product_type": str,
 "product_line": str,
 "datamap_type": str,
 "version": str,
 "alias": str,
 "concept_name": str,
 "context": str,
 "expected_date": int, -- epoch timestamp
 "review_date": int, -- epoch timestamp
 "priority": int,
 "value": float
 },
 "sql": str
 }

Fields

Field	Type	Required	Description
name	string	✅	Name of the Datamap
description	string	❌	Description of the Datamap’s purpose or content
tags	string[]	❌	Array of tags for filtering and search
owner	string	❌	Primary owner of the Datamap
sme	string	❌	Subject Matter Expert for the Datamap
requestor	string	❌	User who requested the Datamap’s creation
custom_attr	object	❌	Additional business metadata (see nested fields below)
custom_attr.product_type	string	❌	Type of product represented (e.g., subscription, physical, digital)
custom_attr.product_line	string	❌	Product line or business unit
custom_attr.datamap_type	string	❌	Classification of Datamap (e.g., source, derived, aggregate)
custom_attr.version	string	❌	Version number of the Datamap
custom_attr.alias	string	❌	Short alias or alternate name for the Datamap
custom_attr.concept_name	string	❌	Conceptual term or business definition associated with this Datamap
custom_attr.context	string	❌	Description of usage context (e.g., "monthly snapshot")
custom_attr.expected_date	integer	❌	Expected data availability date (epoch timestamp)
custom_attr.review_date	integer	❌	Date this Datamap should be reviewed (epoch timestamp)
custom_attr.priority	integer	❌	Priority level (e.g., 1 = highest, 5 = lowest)
custom_attr.value	float	❌	Business value or impact score (can be any numeric value)
sql	string	✅	SQL query that defines the Datamap