Mantic Usage Events API
The usage_events API from Mantic — 1 operation(s) for usage_events.
The usage_events API from Mantic — 1 operation(s) for usage_events.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mantic:mantic-usage-events-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Fast Usage Events API
version: 0.1.0
tags:
- name: usage_events
paths:
/webapp/usage_events:
post:
tags:
- usage_events
summary: Track Usage Events
operationId: track_usage_events_webapp_usage_events_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TrackUsageEventsRequest'
required: true
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- OAuth2AuthorizationCodeBearer: []
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HomeRecommendationOpenedEvent:
properties:
type:
type: string
const: home_recommendation_opened
title: Type
question_id:
type: integer
maximum: 2147483647.0
minimum: 1.0
title: Question Id
request_id:
type: string
format: uuid
title: Request Id
type: object
required:
- type
- question_id
- request_id
title: HomeRecommendationOpenedEvent
description: A recommended question opened from the home page.
SearchResultOpenedEvent:
properties:
type:
type: string
const: search_result_opened
title: Type
item_type:
type: string
enum:
- question
- dashboard
- situation
title: Item Type
item_id:
type: string
maxLength: 64
minLength: 1
title: Item Id
description: Question or dashboard id in decimal, or situation entry id.
request_id:
type: string
format: uuid
title: Request Id
type: object
required:
- type
- item_type
- item_id
- request_id
title: SearchResultOpenedEvent
description: A global search result opened by the reader.
QuestionViewedEvent:
properties:
type:
type: string
const: question_viewed
title: Type
question_id:
type: integer
title: Question Id
type: object
required:
- type
- question_id
title: QuestionViewedEvent
SearchResultShownEvent:
properties:
type:
type: string
const: search_result_shown
title: Type
item_type:
type: string
enum:
- question
- dashboard
- situation
title: Item Type
item_id:
type: string
maxLength: 64
minLength: 1
title: Item Id
description: Question or dashboard id in decimal, or situation entry id.
request_id:
type: string
format: uuid
title: Request Id
type: object
required:
- type
- item_type
- item_id
- request_id
title: SearchResultShownEvent
description: A global search result shown to the reader.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
QuestionSearchEvent:
properties:
type:
type: string
const: question_search
title: Type
query:
type: string
maxLength: 500
minLength: 1
title: Query
question_ids:
items:
type: integer
type: array
title: Question Ids
dashboard_id:
anyOf:
- type: integer
- type: 'null'
title: Dashboard Id
type: object
required:
- type
- query
- question_ids
title: QuestionSearchEvent
description: A free-text question search and the questions it returned, in order.
HomeRecommendationShownEvent:
properties:
type:
type: string
const: home_recommendation_shown
title: Type
question_id:
type: integer
maximum: 2147483647.0
minimum: 1.0
title: Question Id
request_id:
type: string
format: uuid
title: Request Id
type: object
required:
- type
- question_id
- request_id
title: HomeRecommendationShownEvent
description: A recommended question shown on the home page.
QuestionImpressionsEvent:
properties:
type:
type: string
const: question_impressions
title: Type
surface:
type: string
maxLength: 64
minLength: 1
title: Surface
question_ids:
items:
type: integer
type: array
title: Question Ids
type: object
required:
- type
- surface
- question_ids
title: QuestionImpressionsEvent
description: Questions rendered on a named surface that is not a dashboard.
DashboardQuestionImpressionsEvent:
properties:
type:
type: string
const: dashboard_question_impressions
title: Type
dashboard_id:
type: integer
title: Dashboard Id
question_ids:
items:
type: integer
type: array
title: Question Ids
type: object
required:
- type
- dashboard_id
- question_ids
title: DashboardQuestionImpressionsEvent
HomeRecommendationDismissedEvent:
properties:
type:
type: string
const: home_recommendation_dismissed
title: Type
question_id:
type: integer
maximum: 2147483647.0
minimum: 1.0
title: Question Id
request_id:
type: string
format: uuid
title: Request Id
type: object
required:
- type
- question_id
- request_id
title: HomeRecommendationDismissedEvent
description: A recommended question dismissed from the home page.
TrackUsageEventsRequest:
properties:
events:
items:
oneOf:
- $ref: '#/components/schemas/QuestionViewedEvent'
- $ref: '#/components/schemas/DashboardQuestionImpressionsEvent'
- $ref: '#/components/schemas/QuestionImpressionsEvent'
- $ref: '#/components/schemas/QuestionSearchEvent'
- $ref: '#/components/schemas/HomeRecommendationShownEvent'
- $ref: '#/components/schemas/HomeRecommendationOpenedEvent'
- $ref: '#/components/schemas/HomeRecommendationDismissedEvent'
- $ref: '#/components/schemas/SearchResultShownEvent'
- $ref: '#/components/schemas/SearchResultOpenedEvent'
discriminator:
propertyName: type
mapping:
dashboard_question_impressions: '#/components/schemas/DashboardQuestionImpressionsEvent'
home_recommendation_dismissed: '#/components/schemas/HomeRecommendationDismissedEvent'
home_recommendation_opened: '#/components/schemas/HomeRecommendationOpenedEvent'
home_recommendation_shown: '#/components/schemas/HomeRecommendationShownEvent'
question_impressions: '#/components/schemas/QuestionImpressionsEvent'
question_search: '#/components/schemas/QuestionSearchEvent'
question_viewed: '#/components/schemas/QuestionViewedEvent'
search_result_opened: '#/components/schemas/SearchResultOpenedEvent'
search_result_shown: '#/components/schemas/SearchResultShownEvent'
type: array
maxItems: 100
minItems: 1
title: Events
type: object
required:
- events
title: TrackUsageEventsRequest
securitySchemes:
OAuth2AuthorizationCodeBearer:
type: oauth2
flows:
authorizationCode:
scopes: {}
authorizationUrl: https://app.mantic.com/auth/oauth2/authorize
tokenUrl: https://app.mantic.com/auth/oauth2/token