Unleash

Unleash Notifications API

API for managing [notifications](https://docs.getunleash.io/concepts/notifications).

Documentation GitHub OpenAPI

Operations 2

GET /api/admin/notifications Retrieves a List of Notifications #

POST /api/admin/notifications/read Mark Notifications as Read #

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/unleash-notifications-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: Unleash Admin Addons Notifications API
  version: 7.4.1
  description: Create, update, and delete [Unleash addons](https://docs.getunleash.io/addons).
servers:
- url: https://app.unleash-instance.example.com
  description: Your Unleash instance (replace with your actual URL)
security:
- apiKey: []
- bearerToken: []
tags:
- name: Notifications
  description: API for managing [notifications](https://docs.getunleash.io/concepts/notifications).
paths:
  /api/admin/notifications:
    get:
      summary: Retrieves a List of Notifications
      description: '**Enterprise feature**


        A user may get relevant notifications from the projects they are a member of'
      tags:
      - Notifications
      operationId: getNotifications
      responses:
        '200':
          description: notificationsSchema
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notificationsSchema'
  /api/admin/notifications/read:
    post:
      summary: Mark Notifications as Read
      description: '**Enterprise feature**


        Allow to select which notifications were read and saving a read date'
      tags:
      - Notifications
      operationId: markNotificationsAsRead
      requestBody:
        description: markNotificationsAsReadSchema
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/markNotificationsAsReadSchema'
      responses:
        '200':
          description: This response has no body.
components:
  schemas:
    notificationsSchema:
      type: array
      description: A list of [notifications](https://docs.getunleash.io/concepts/notifications)
      items:
        type: object
        additionalProperties: false
        required:
        - id
        - message
        - link
        - notificationType
        - createdBy
        - createdAt
        - readAt
        properties:
          id:
            type: number
            example: 1
            description: The id of this notification
          message:
            type: string
            example: Your change request got approved
            description: The actual notification message
          link:
            type: string
            example: /myunleash/projects/myproject/change-requests/46
            description: The link to change request or feature flag the notification refers to
          notificationType:
            enum:
            - change-request
            - toggle
            description: The type of the notification used e.g. for the graphical hints
          createdBy:
            type: object
            additionalProperties: false
            properties:
              username:
                type:
                - string
                - 'null'
                example: Jane Smith
                description: The name of the user who triggered the notification
              imageUrl:
                type:
                - string
                - 'null'
                example: https://gravatar.com/avatar/758f27d1f066779a62a65665242b8780107df403509a62a9e8a5924df5469f68?s=42&d=retro&r=g
                description: The avatar url of the user who triggered the notification
          createdAt:
            type: string
            format: date-time
            example: '2022-12-02T13:17:12.445Z'
            description: The date and time when the notification was created
          readAt:
            type:
            - string
            - 'null'
            format: date-time
            example: '2022-12-02T13:17:12.445Z'
            description: The date and time when the notification was read or marked as read, otherwise `null`
    markNotificationsAsReadSchema:
      type: object
      description: Data used to mark notifications as being read
      required:
      - notifications
      properties:
        notifications:
          type: array
          description: A list of IDs belonging to the notifications you want to mark as read.
          items:
            type: integer
            description: A notification ID
            minimum: 0
            example: 5
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: API key needed to access this API
    bearerToken:
      type: http
      scheme: bearer
      description: API key needed to access this API, in Bearer token format