Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.geogen.io/llms.txt

Use this file to discover all available pages before exploring further.

A domain group lets you tie several entity records together. For example, when one brand is tracked under multiple domains (acme.com, acme.io, getacme.com) and you want their analytics merged behind a single primary. Each group has one primary entity and two or more member entities.

geogen domain-groups list

List domain groups in the workspace. Maps to GET /v1/domain-groups.
geogen domain-groups list
geogen domain-groups list --entity ent_123    # only groups scoped to this tracking
FlagDescription
--entity <id>Filter to groups scoped to this entity tracking

geogen domain-groups get

Fetch a single domain group with its full member detail. The detailed payload is printed as JSON.
geogen domain-groups get --group-id grp_abc

geogen domain-groups create

Create a new group from 2+ entities. Maps to POST /v1/domain-groups.
geogen domain-groups create \
  --primary ent_primary \
  --entities ent_primary,ent_alias_io,ent_alias_get \
  --name "Acme (all domains)"
FlagDescription
--primary <ref>Primary entity, given as entityTrackingId or entity UUID (required)
--entities <refs>Comma-separated entity refs, must include --primary (required, 2+)
--name <name>Group name. Defaults to the primary entity’s name.
--entity <id>Optional entity tracking to scope the group to
You can pass either an entityTrackingId (the id from geogen entities list) or a raw entity UUID. The API resolves both forms.

geogen domain-groups update

Update a group’s name, primary, or member list. Maps to PATCH /v1/domain-groups.
geogen domain-groups update \
  --group-id grp_abc \
  --name "Acme (renamed)" \
  --entities ent_primary,ent_alias_io,ent_alias_get,ent_alias_co
FlagDescription
--group-id <id>Domain group ID (required)
--name <name>New name
--primary <ref>New primary entity ref
--entities <refs>New comma-separated member list (replaces the existing set; 2+)
If you pass --entities, the new list must contain the (possibly new) primary entity.

geogen domain-groups delete

Delete a domain group. Maps to DELETE /v1/domain-groups.
geogen domain-groups delete --group-id grp_abc
Deleting a group does not delete any of its member entities, only the grouping. Their individual analytics remain intact.