Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Keen Saved Queries API

The Keen Saved Queries API enables developers to create and manage reusable query definitions. Saved queries store query parameters as named resources that can be retrieved and executed later, enabling consistent analytics across applications and simplifying the management of complex query configurations.

Keen Saved Queries API is one of 6 APIs that Keen publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Analytics, Queries, and Saved Queries. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 5 operations across 3 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version 3.0.

Requests are made against a single base URL, https://api.keen.io/3.0.

5 operations 3 paths 3 schemas 1 DELETE3 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
3.0
Server
https://api.keen.io/3.0
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

Keen Saved Queries API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (masterKey). An API key is passed in the header as Authorization (readKey). By default, every request must be authenticated.

  • masterKey — Keen Master Key for management endpoints.
  • readKey — Keen Read Key for retrieving cached results.

Paths & Operations 5

Across 3 paths, the API surfaces 5 operations — 1 DELETE, 3 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Saved Queries 5

Create, manage, and execute reusable saved queries.

GET
/projects/{projectId}/queries/saved
Keen List saved queries
listSavedQueries 1 param → 200401
GET
/projects/{projectId}/queries/saved/{queryName}
Keen Get a saved query
getSavedQuery 2 params → 200401404
PUT
/projects/{projectId}/queries/saved/{queryName}
Keen Create or update a saved query
createOrUpdateSavedQuery 2 params body → 201401
DELETE
/projects/{projectId}/queries/saved/{queryName}
Keen Delete a saved query
deleteSavedQuery 2 params → 204401
GET
/projects/{projectId}/queries/saved/{queryName}/result
Keen Run a saved query
runSavedQuery 2 params → 200401

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are Error (2 properties), SavedQueryDefinition (2 properties). Each schema is shown below with its type and property counts.

SavedQuery
SavedQueryDefinition
object
2 properties 1 required
Error
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

keen-saved-queries-api-openapi.yml Raw ↑

Other APIs Keen publishes across the network.

Keen Cached Queries API
Keen Collections API
Keen Events API
Keen Extractions API
Keen Queries API