Skip to content

Journey group tools

A journey group bundles related journeys under one name so they can be audited together. Six tools.

List journey groups for a project, each with its member journeys and journey count.

NameTypeRequired
project_idstringyes

Returns: the project’s groups, each with its members. Not paginated.

Create a journey group for a project. The group is created empty; add journeys with set_journey_group_members.

NameTypeRequired
organization_idstringyes
project_idstringyes
namestringyes
descriptionstringno

Returns: the created group.

Update a journey group’s name or description.

NameTypeRequired
organization_idstringyes
journey_group_idstringyes
namestringno
descriptionstringno

Does not change membership.

Returns: the updated group.

Delete a journey group. The member journeys themselves are not deleted, only the grouping.

NameTypeRequired
organization_idstringyes
journey_group_idstringyes

Returns: the confirmation line Deleted journey group: <id>.

Set the full member list of a journey group.

NameTypeRequiredNotes
organization_idstringyes
journey_group_idstringyes
journey_idsstring[]yesThe complete desired set of members.

REPLACE semantics. The list you send becomes the membership; it is not a delta. Sending one id leaves the group holding exactly one journey.

Returns: the group with its updated journey count and members.

Start an audit for every journey in a group — one run per member journey.

NameTypeRequired
organization_idstringyes
project_idstringyes
journey_group_idstringyes

One journey failing to start does not abort the rest.

Returns: a summary line sorting the member journeys into three groups:

GroupMeaning
Started N audits (run ids: …)New runs, one per journey.
N already had a run in flight: <name> (<run id>)An audit of that journey was already running; nothing new started, and the id is the run already going.
Skipped N (over quota or refused): <name>Did not start and is not running.

Only the groups that apply are printed. An empty group returns Group has no journeys to run; an unknown group id returns an error block.

Unlike start_agentic_audit, this returns run ids directly, not cloud run request ids. Run ids are what get_agentic_audit_report and cancel_audit take. get_audit_progress takes a cloud run request id, so it cannot poll a run started this way.