Lytics

Lytics System Events API

Get internal Lytics system events. These events are generally related to internal changes to state of an account. Common changes are CRUD Operations (Create, Update, Delete) of *Account*, *Admin User*, etc.

GitHub OpenAPI

Operations 2

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

GET /api/event Search the account activity log · System Events Query #
Ask an LLM
“Which segments were created in the last two weeks?”
“Can I see what a particular admin user did on the account?”
Tell an agent
List system events of type {type} with verb {verb}.
Show system events after {after} for object {id}.
GET /api/event/:id Get one system event · System Event Fetch #
Ask an LLM
“Can I fetch the details of a single system event?”
“What does one activity log entry contain?”
Tell an agent
Show the details of one system event by id.
Fetch a single activity log entry.

Documentation

📖
Documentation
https://docs.lytics.com/reference
📖
APIReference
https://docs.lytics.com/reference

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lytics/refs/heads/main/openapi/lytics-system-events-api-openapi.yml

Other Resources

🔗
OpenAPI Source
https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/lytics/refs/heads/main/mcp/lytics-tool-crosswalk.yml
🔗
OpenAPI Source
https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx

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/lytics:lytics-system-events-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

lytics-system-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: V1 Lytics System Events API
  version: 1.0.0
  description: 'The Lytics API is a _restful_ *JSON* api that includes:

    * *Data Collection* api''s for collection, and upload of custom data.'
servers:
- url: https://api.lytics.io
tags:
- name: System Events
  description: 'Get internal Lytics system events. These events

    are generally related to internal changes to state of

    an account. Common changes are CRUD Operations (Create,

    Update, Delete) of *Account*, *Admin User*, etc.'
paths:
  /api/event:
    get:
      responses:
        '200':
          description: OK
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SystemEventsModel'
              examples:
                response:
                  value:
                    data:
                    - id: 13564999017e8b0e9994ff16411fd19b
                      ts: '1465584982676'
                      priority: 2
                      subject_type: topic-document
                      subject_id: '-1894399319812759219'
                      verb: created
                      account_id: 1234abcdefgh
                    - id: c57172d7d22e1c7ac4c80ce713e6e7cb
                      ts: '1465844458666'
                      priority: 2
                      subject_type: entity
                      subject_id: user/email/a.user@gmail.com
                      verb: clustered
                      related:
                      - type: segment
                        id: 791734b084019d99c82a475264464304
                      account_id: 1234abcdefgh
                      context:
                        in: '2016-06-13T18:58:29Z'
                    message: success
                    status: 200
      security:
      - ApiKeyAuth: []
      summary: System Events Query
      operationId: SystemEventsQuery
      description: 'Get list of system events.


        ```

        # get the dashboard news items

        curl -s -H "Authorization: $LIOKEY" \

        -XGET "https://api.lytics.io/api/event?query=dashboard_news" | jq ''.''


        # get list of all segments created in last 2 weeks

        curl -s -H "Authorization: $LIOKEY" \

        -XGET "https://api.lytics.io/api/event?type=segment&start=now-2w&limit=100&verb=created" | jq ''.''


        # get list of all events performed by user X


        # 1) first find a user id

        curl -s -H "Authorization: $LIOKEY" \

        -XGET "https://api.lytics.io/api/user/user.email@yourdomain.com" | jq ''.''


        # 2) get the id for that user

        curl -s -H "Authorization: $LIOKEY" \

        -XGET "https://api.lytics.io/api/event?type=user&id=USER_ID_FROM_PREVIOUS" | jq ''.''


        ```'
      tags:
      - System Events
      parameters:
      - name: account_id
        in: query
        description: Your Lytics account ID.
        required: false
        schema:
          type: string
      - name: before
        in: query
        description: 'Start fetching items with dates older than:   "now-3d" (now-2h, now-1w, "2016-03-03").  Date math, or absolute date.'
        required: false
        schema:
          type: string
          default: now-3d
      - name: after
        in: query
        description: 'Start fetching items with dates after:   "now-3d" (now-2h, now-1w, "2016-03-03").  Date math, or absolute date.'
        required: false
        schema:
          type: string
          default: now-3d
      - name: limit
        in: query
        description: Should segments this user is member of be included?
        required: false
        schema:
          type: integer
          default: 20
      - name: verb
        in: query
        description: Verb (created, updated, deleted, status, clustered)
        required: false
        schema:
          type: string
          default: '``'
      - name: type
        in: query
        description: Type of Object (entity, segment, work, account, user)
        required: false
        schema:
          type: string
          default: '``'
      - name: id
        in: query
        description: Id of Object (entity, segment, work, account, user)
        required: false
        schema:
          type: string
          default: '``'
      x-operation-id-source: normalized
      x-operation-id-original: System Events Query
  /api/event/:id:
    get:
      responses:
        '200':
          description: OK
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SystemEventModel'
              examples:
                response:
                  value:
                    data:
                      id: c57172d7d22e1c7ac4c80ce713e6e7cb
                      ts: '1465844458666'
                      priority: 2
                      subject_type: entity
                      subject_id: user/email/a.user@gmail.com
                      verb: clustered
                      related:
                      - type: segment
                        id: 791734b084019d99c82a475264464304
                      account_id: 1234abcdefgh
                      context:
                        in: '2016-06-13T18:58:29Z'
                    message: success
                    status: 200
      security:
      - ApiKeyAuth: []
      summary: System Event Fetch
      operationId: SystemEventFetch
      description: Get Single System Event
      tags:
      - System Events
      x-operation-id-source: normalized
      x-operation-id-original: System Event Fetch
components:
  schemas:
    SystemEventsModel:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              ts:
                type: string
              priority:
                type: number
              subject_type:
                type: string
              subject_id:
                type: string
              verb:
                type: string
              account_id:
                type: string
              related:
                type: array
                items:
                  type: object
                  properties:
                    type:
                      type: string
                    id:
                      type: string
              context:
                type: object
                properties:
                  in:
                    type: string
            required:
            - id
            - ts
            - priority
            - subject_type
            - subject_id
            - verb
            - account_id
        message:
          type: string
        status:
          type: number
      example:
        data:
        - id: 13564999017e8b0e9994ff16411fd19b
          ts: '1465584982676'
          priority: 2
          subject_type: topic-document
          subject_id: '-1894399319812759219'
          verb: created
          account_id: 1234abcdefgh
        - id: c57172d7d22e1c7ac4c80ce713e6e7cb
          ts: '1465844458666'
          priority: 2
          subject_type: entity
          subject_id: user/email/a.user@gmail.com
          verb: clustered
          related:
          - type: segment
            id: 791734b084019d99c82a475264464304
          account_id: 1234abcdefgh
          context:
            in: '2016-06-13T18:58:29Z'
        message: success
        status: 200
    SystemEventModel:
      type: object
      properties:
        data:
          type: object
          properties:
            id:
              type: string
            ts:
              type: string
            priority:
              type: number
            subject_type:
              type: string
            subject_id:
              type: string
            verb:
              type: string
            related:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                  id:
                    type: string
            account_id:
              type: string
            context:
              type: object
              properties:
                in:
                  type: string
        message:
          type: string
        status:
          type: number
      example:
        data:
          id: c57172d7d22e1c7ac4c80ce713e6e7cb
          ts: '1465844458666'
          priority: 2
          subject_type: entity
          subject_id: user/email/a.user@gmail.com
          verb: clustered
          related:
          - type: segment
            id: 791734b084019d99c82a475264464304
          account_id: 1234abcdefgh
          context:
            in: '2016-06-13T18:58:29Z'
        message: success
        status: 200
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: Authorization
      type: apiKey
x-readme:
  explorer-enabled: true
  proxy-enabled: true