Flagsmith Analytics API

SDK analytics and telemetry.

Documentation GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/v1/analytics/flags/ Report flag evaluation analytics (v1) · Api v1 analytics flags create #

Ask an LLM

“Where does an SDK send flag analytics events on the original v1 endpoint?”

“Can I post feature flag usage counts to the legacy analytics endpoint?”

Tell an agent

Send this batch of flag analytics events to the v1 flag analytics endpoint.

Post flag usage counts using the older v1 analytics route.

POST /api/v1/analytics/telemetry/ Send self-hosted installation telemetry · Api v1 analytics telemetry create #

Ask an LLM

“How does a self-hosted Flagsmith install report its telemetry?”

“What counts does the self-hosted telemetry event include, like projects, features and users?”

Tell an agent

Report telemetry for this self-hosted install with {organisations} organisations, {projects} projects and {features} features.

Send self-hosted telemetry showing {users} users in environment type {env}.

POST /api/v2/analytics/flags/ Report flag evaluations (v2) · Api v2 analytics flags create #

Ask an LLM

“Can I submit a list of flag evaluations to the v2 analytics endpoint?”

“Which analytics endpoint takes an evaluations array rather than raw counts?”

Tell an agent

Submit these flag evaluations {evaluations} to v2 analytics.

Record the evaluation batch {evaluations} with the newer v2 flag analytics call.

Specifications

⚙

OpenAPI

https://artifacts.apis.io/flagsmith/openapi/flagsmith-analytics-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/flagsmith:flagsmith-analytics-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Flagsmith Analytics API
  version: v1
  description: Flagsmith's Core and SDK APIs. Check out Flagsmith documentation.
  contact:
    email: support@flagsmith.com
  license:
    name: BSD License
    identifier: BSD-3-Clause
tags:
- name: Analytics
  description: SDK analytics and telemetry.
paths:
  /api/v1/analytics/flags/:
    post:
      operationId: api_v1_analytics_flags_create
      description: Class to handle flag analytics events
      tags:
      - Analytics
      security:
      - Environment API Key: []
      responses:
        '201':
          description: No response body
      summary: Api v1 analytics flags create
      x-summary-source: derived
  /api/v1/analytics/telemetry/:
    post:
      operationId: api_v1_analytics_telemetry_create
      description: 'Class to handle telemetry events from self hosted APIs so we can aggregate and track

        self hosted installation data'
      tags:
      - Analytics
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Telemetry'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Telemetry'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Telemetry'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Telemetry'
          description: ''
      summary: Api v1 analytics telemetry create
      x-summary-source: derived
  /api/v2/analytics/flags/:
    post:
      operationId: api_v2_analytics_flags_create
      tags:
      - Analytics
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SDKAnalyticsFlags'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/SDKAnalyticsFlags'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/SDKAnalyticsFlags'
        required: true
      security:
      - Environment API Key: []
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SDKAnalyticsFlags'
          description: ''
      summary: Api v2 analytics flags create
      x-summary-source: derived
components:
  schemas:
    SDKAnalyticsFlagsSerializerDetail:
      type: object
      properties:
        feature_name:
          type: string
        identity_identifier:
          type: string
        enabled_when_evaluated:
          type: boolean
        count:
          type: integer
      required:
      - count
      - enabled_when_evaluated
      - feature_name
    SDKAnalyticsFlags:
      type: object
      properties:
        evaluations:
          type: array
          items:
            $ref: '#/components/schemas/SDKAnalyticsFlagsSerializerDetail'
      required:
      - evaluations
    Telemetry:
      type: object
      properties:
        organisations:
          type: integer
        projects:
          type: integer
        environments:
          type: integer
        features:
          type: integer
        segments:
          type: integer
        users:
          type: integer
        debug_enabled:
          type: boolean
        env:
          type: string
      required:
      - debug_enabled
      - env
      - environments
      - features
      - organisations
      - projects
      - segments
      - users
  securitySchemes:
    Cohort_Sync_Key:
      type: http
      scheme: bearer
      description: For cohort sync endpoints called by an external cohort source, such as Amplitude.
    Cohort_Sync_Key__Basic:
      type: http
      scheme: basic
      description: For cohort sync endpoints called by an external cohort source that can only send Basic credentials, such as Mixpanel. The key is the password; the username is ignored.
    Environment_API_Key:
      type: apiKey
      in: header
      name: X-Environment-Key
      description: For SDK endpoints. <a href='https://docs.flagsmith.com/clients/rest#public-api-endpoints'>Find out more</a>.
    Master_API_Key:
      type: apiKey
      in: header
      name: Authorization
      description: For Management API endpoints. <a href='https://docs.flagsmith.com/integrating-with-flagsmith/flagsmith-api-overview/management-api'>Find out more</a>.
    basicAuth:
      type: http
      scheme: basic
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"
x-provenance:
  method: harvested
  publisher: Flagsmith
  source: https://api.flagsmith.com/api/v1/swagger.yaml
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)