add_dataset_members
Add records from registered tables to a dataset as members, auto-incrementing its minor version. Supports RID lists or grouped by table for faster bulk additions.
Instructions
Add records as dataset elements. Auto-increments minor version.
Records must be from tables registered as dataset element types. Use add_dataset_element_type() to register a table, or list_dataset_element_types() to see which tables are already registered.
Accepts members in two forms:
List of RIDs (member_rids): Each RID is auto-resolved to its table. Simpler but slower for large numbers.
Dict by table name (members_by_table): Maps table names to RID lists. Faster (skips RID resolution) and lets you add members of different types in one call. Recommended when you know the table names.
Exactly one of member_rids or members_by_table must be provided.
Args: dataset_rid: The RID of the dataset to add members to. member_rids: List of RIDs to add (e.g., ["2-ABC", "2-DEF"]). Auto-resolves each RID to its table. members_by_table: Dict mapping table names to RID lists (e.g., {"Subject": ["2-ABC"], "Observation": ["2-DEF", "2-GHI"]}). Faster than member_rids for large datasets. description: Optional description for the version increment that records why these members were added. Stored in the dataset history.
Returns: JSON with status, added_count, dataset_rid.
Example: add_dataset_members("1-ABC", member_rids=["2-DEF", "2-GHI"]) add_dataset_members("1-ABC", members_by_table={"Subject": ["2-DEF"], "Image": ["2-GHI"]})
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_rid | Yes | ||
| description | No | ||
| member_rids | No | ||
| members_by_table | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |