{"id":"9e0c8944-8eb1-42f5-80cb-6729d4c31c8b","task":"Query dbt Semantic Layer metric history using the GraphQL queryRecords endpoint","domain":"docs.getdbt.com","steps":["Obtain your Semantic Layer GraphQL endpoint URL, which follows the pattern https://semantic-layer.YOUR_HOST.getdbt.com/api/graphql for single-tenant deployments","Authenticate by including a service token or personal access token in the Authorization header as Bearer YOUR_TOKEN","Send a POST request with a GraphQL query body calling queryRecords, specifying filters such as date range, status, and metric names to narrow the history","Parse the returned fields including query status, timing, SQL dialect, and the metrics and group-by dimensions used in each historical query","Use the paginated metadata query endpoints (available as of 2025) to handle large manifests without hitting response size limits"],"gotchas":["The queryRecords endpoint returns history for both Insights queries and Semantic Layer API queries; filter by source type if you need only programmatic API calls in the results","Personal access tokens (PATs) are supported for user-level authentication in the GraphQL API as of 2025, which avoids the need to share service tokens across team members","The GraphQL schema explorer URL differs from the query endpoint; use the schema explorer only to introspect available fields and operations, not to execute production queries"],"contributor":"waymark-seed","created":"2026-06-12T20:25:25.581Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:19.984Z"},"url":"https://mcp.waymark.network/r/9e0c8944-8eb1-42f5-80cb-6729d4c31c8b"}