> ## Documentation Index
> Fetch the complete documentation index at: https://kavenio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Mastodon engagement items

> Returns persisted engagement items for a connected Mastodon account, including synced notifications, conversations, and status replies.



## OpenAPI

````yaml /api/openapi.json get /v1/accounts/{accountId}/mastodon-engagement
openapi: 3.1.0
info:
  title: Kavenio API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://kavenio.com/terms
  description: Generated OpenAPI document for the stable Kavenio public API.
servers:
  - url: https://api.kavenio.com
security:
  - bearerAuth: []
tags:
  - name: API keys
    description: Manage Kavenio API keys for the authenticated user.
  - name: Integrations
    description: Connect automation clients and manage workflow subscriptions.
  - name: Feature requests
    description: Submit feature requests from authenticated users.
  - name: Posts
    description: Create, schedule, update, and manage post lifecycle actions.
  - name: Queue
    description: Manage reusable post queue schedules and preview slots.
  - name: Media
    description: Upload, presign, and validate media assets.
  - name: Validation
    description: Validate post payloads and platform content length limits.
  - name: Connect
    description: Start and complete account connection flows.
  - name: Accounts
    description: Manage connected social accounts and account health.
  - name: Telegram
    description: Manage Telegram-specific connected account settings.
  - name: Discord
    description: Manage Discord messages, roles, pins, events, and settings.
  - name: Google Business
    description: Manage Google Business locations, reviews, and helpers.
  - name: Ads
    description: Create, read, cancel, and inspect advertising resources.
  - name: Ad audiences
    description: Manage advertising audiences and audience members.
  - name: Ad catalogs
    description: Inspect advertising catalogs and product sets.
  - name: Ad targeting
    description: Search targeting entities and estimate audience reach.
  - name: Ad conversions
    description: Manage conversion destinations and send conversion events.
  - name: Ad leads
    description: Manage lead forms and retrieve advertising leads.
  - name: Tracking tags
    description: Manage Meta tracking tags and tag sharing.
  - name: Platform credentials
    description: Manage organization platform app credentials.
  - name: Analytics
    description: Read provider analytics and operational inbox data.
  - name: WhatsApp conversions
    description: Read and send WhatsApp conversion events.
  - name: Activity
    description: Read operational activity events.
  - name: Webhooks
    description: Manage webhook endpoints and delivery logs.
paths:
  /v1/accounts/{accountId}/mastodon-engagement:
    get:
      tags:
        - Accounts
      summary: List Mastodon engagement items
      description: >-
        Returns persisted engagement items for a connected Mastodon account,
        including synced notifications, conversations, and status replies.
      operationId: listMastodonEngagementItems
      parameters:
        - in: path
          name: accountId
          schema:
            type: string
            minLength: 16
            maxLength: 16
            pattern: ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
          required: true
        - in: query
          name: itemType
          schema:
            type: string
            enum:
              - notification
              - conversation
              - status_reply
        - in: query
          name: notificationType
          schema:
            type: string
            enum:
              - mention
              - status
              - reblog
              - follow
              - follow_request
              - favourite
              - poll
              - update
              - admin.sign_up
              - admin.report
              - severed_relationships
              - moderation_warning
              - unknown
        - in: query
          name: unreadOnly
          schema:
            anyOf:
              - type: boolean
              - type: string
                const: 'true'
              - type: string
                const: 'false'
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - in: query
          name: cursor
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: Mastodon engagement items returned.
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      ok:
                        type: boolean
                        x-kavenio-const: true
                      data:
                        type: object
                        properties:
                          accountId:
                            type: string
                            minLength: 16
                            maxLength: 16
                            pattern: >-
                              ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                          items:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                  minLength: 16
                                  maxLength: 16
                                  pattern: >-
                                    ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                                accountId:
                                  type: string
                                  minLength: 16
                                  maxLength: 16
                                  pattern: >-
                                    ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                                profileId:
                                  type: string
                                  minLength: 1
                                  maxLength: 255
                                itemType:
                                  type: string
                                  enum:
                                    - notification
                                    - conversation
                                    - status_reply
                                providerItemId:
                                  type: string
                                  minLength: 1
                                notificationType:
                                  type: string
                                  enum:
                                    - mention
                                    - status
                                    - reblog
                                    - follow
                                    - follow_request
                                    - favourite
                                    - poll
                                    - update
                                    - admin.sign_up
                                    - admin.report
                                    - severed_relationships
                                    - moderation_warning
                                    - unknown
                                providerStatusId:
                                  type: string
                                  minLength: 1
                                providerConversationId:
                                  type: string
                                  minLength: 1
                                actor:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                      minLength: 1
                                    username:
                                      type: string
                                      minLength: 1
                                    acct:
                                      type: string
                                      minLength: 1
                                    displayName:
                                      type: string
                                    url:
                                      type: string
                                      format: uri
                                    avatar:
                                      type: string
                                      format: uri
                                  required:
                                    - id
                                  additionalProperties: false
                                status:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                      minLength: 1
                                    uri:
                                      type: string
                                      minLength: 1
                                    url:
                                      type: string
                                      format: uri
                                    contentHtml:
                                      type: string
                                    text:
                                      type: string
                                    createdAt:
                                      type: string
                                      minLength: 1
                                    visibility:
                                      type: string
                                      minLength: 1
                                    sensitive:
                                      type: boolean
                                    spoilerText:
                                      type: string
                                    repliesCount:
                                      type: integer
                                      minimum: 0
                                      maximum: 9007199254740991
                                    reblogsCount:
                                      type: integer
                                      minimum: 0
                                      maximum: 9007199254740991
                                    favouritesCount:
                                      type: integer
                                      minimum: 0
                                      maximum: 9007199254740991
                                    favourited:
                                      type: boolean
                                    reblogged:
                                      type: boolean
                                    bookmarked:
                                      type: boolean
                                    muted:
                                      type: boolean
                                    account:
                                      type: object
                                      properties:
                                        id:
                                          type: string
                                          minLength: 1
                                        username:
                                          type: string
                                          minLength: 1
                                        acct:
                                          type: string
                                          minLength: 1
                                        displayName:
                                          type: string
                                        url:
                                          type: string
                                          format: uri
                                        avatar:
                                          type: string
                                          format: uri
                                      required:
                                        - id
                                      additionalProperties: false
                                    inReplyToId:
                                      type: string
                                      minLength: 1
                                    inReplyToAccountId:
                                      type: string
                                      minLength: 1
                                    raw:
                                      type: object
                                      propertyNames:
                                        type: string
                                      additionalProperties: {}
                                  required:
                                    - id
                                  additionalProperties: false
                                isRead:
                                  type: boolean
                                isDismissed:
                                  type: boolean
                                occurredAt:
                                  type: string
                                  minLength: 1
                                fetchedAt:
                                  type: string
                                  minLength: 1
                                createdAt:
                                  type: string
                                  minLength: 1
                                updatedAt:
                                  type: string
                                  minLength: 1
                              required:
                                - id
                                - accountId
                                - profileId
                                - itemType
                                - providerItemId
                                - isRead
                                - isDismissed
                                - occurredAt
                                - fetchedAt
                                - createdAt
                                - updatedAt
                              additionalProperties: false
                          nextCursor:
                            type: string
                            minLength: 1
                        required:
                          - accountId
                          - items
                        additionalProperties: false
                    required:
                      - ok
                      - data
                    additionalProperties: false
                  - type: object
                    properties:
                      ok:
                        type: boolean
                        x-kavenio-const: false
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            minLength: 1
                          message:
                            type: string
                            minLength: 1
                          details: {}
                        required:
                          - code
                          - message
                        additionalProperties: false
                    required:
                      - ok
                      - error
                    additionalProperties: false
        '401':
          description: Authentication failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    x-kavenio-const: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        minLength: 1
                      message:
                        type: string
                        minLength: 1
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
        '404':
          description: Connected account not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    x-kavenio-const: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        minLength: 1
                      message:
                        type: string
                        minLength: 1
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
        '422':
          description: Request validation failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    x-kavenio-const: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        minLength: 1
                      message:
                        type: string
                        minLength: 1
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
        '500':
          description: Mastodon engagement lookup failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    x-kavenio-const: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        minLength: 1
                      message:
                        type: string
                        minLength: 1
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Clerk session or OAuth token

````