Insights

Execute analytics query

post

https://app.neostore.cloudhttps://app-qa.neostore.cloud

/api/{tenantId}/insights/query

Runs a custom analytics query and returns results in tabular format.

Authorization

Requires Insights.Read scope.

Rate Limiting

Limited to 60 requests per interval to protect analytics infrastructure.

Query Language

Typically uses Kusto Query Language (KQL) syntax:

Passes
| where timestamp > ago(7d)
| summarize count() by passType
| order by count_ desc

Parameters

Supports parameterized queries for security and reusability:

{
  "query": "Events | where Name == name | take 100",
  "parameters": { "name": "Pass:Installed" }
}

Use Cases

• Custom dashboards
• Business intelligence reports
• Data exports
• Trend analysis

Performance

• Query timeout: Configurable per tenant
• Result limits: May be enforced
• Caching: Not automatic - implement client-side if needed

Required scopes

This endpoint requires the following scopes:

Authorizations

admin-bearerapiKey

OAuth2implicitRequired

Authorization URL:

Path parameters

tenantIdstringRequired

Body

application/jsontext/jsonapplication/*+json

querystringRequired

optionsobject · QueryOptionsOptional

Responses

200

Query executed successfully

text/plainapplication/jsontext/json

columnsstring[]Optional

400

Invalid query syntax or parameters

text/plainapplication/jsontext/json

401

Not authorized

text/plainapplication/jsontext/json

500

Internal server error while executing query

post/api/{tenantId}/insights/query

HTTPcURLJavaScriptPython

POST /api/{tenantId}/insights/query HTTP/1.1
Host: app.neostore.cloud
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "query": "text",
  "parameters": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "options": {}
}

application/jsontext/jsonapplication/*+json

{
  "columns": [
    "text"
  ],
  "rows": [
    []
  ]
}