---
title: "Execute Query"
method: POST
path: "/copilot/semantic-metrics/query"
tags: ["Semantic Metrics"]
---

# Execute Query

`POST /copilot/semantic-metrics/query`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/copilot/semantic-metrics/query`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Compile and execute a semantic metric query with the caller's row scope.

``user_group_id`` is the team the caller selected (``x-user-group-id``)
after membership validation; ``rbac_scope_enabled`` is the tenant RBAC
decision for this caller (False for owners with no team, True for
non-owners and for anyone who selected a team). Both are threaded into
the request context so ``query_metric`` executes through the same
row-policy settings as the Studio MCP path. ``require_team_or_owner_scope``
refuses a non-owner with no team before this body runs.

## Query parameters

- `navigationSource` string, nullable

## Request body

- MetricQueryRequest
  - `metrics` string[], required
  - `group_by` string[], nullable
  - `where` string, nullable
  - `order_by` string[], nullable
  - `limit` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-30** `a1870d258a3a`: 1 info
  - added the new optional `query` request parameter `navigationSource`

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/copilot/semantic-metrics/query/post.md)

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)