CortexPlus Notifications API

The Notifications API from CortexPlus — 8 operation(s) for notifications.

GitHub OpenAPI

Operations 11

GET /v1/notifications List inbox notifications #
GET /v1/notifications/unread Count unread notifications #
POST /v1/notifications/read Mark notifications as read #
POST /v1/notifications/read-all Mark every notification as read #
POST /v1/notifications/archive Remove notifications from the inbox #
GET /v1/notifications/preferences Get notification preferences #
PATCH /v1/notifications/preferences Update notification preferences #
GET /v1/notifications/push Which push providers are configured on the server #
PUT /v1/notifications/push Register this device for push #
DELETE /v1/notifications/push Stop push to a token or endpoint #
POST /v1/notifications/test Send a test notification #

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/cortexplus-io:cortexplus-io-notifications-api"
All apis
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.

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.

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

OpenAPI Specification

cortexplus-io-notifications-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cortexplus Io Notifications API
  version: 1.0.0
  description: 'Operations tagged Notifications across 2 of this provider''s published API definitions: cortexplus-io-openapi.json, cortexplus-io-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.cortexplus.io
security:
- bearerAuth: []
tags:
- name: Notifications
paths:
  /v1/notifications:
    get:
      operationId: listNotifications
      summary: List inbox notifications
      description: Return the notification inbox, newest first. Page with before=nextCursor.
      x-openai-isConsequential: false
      parameters:
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: before
        in: query
        schema:
          type: string
          format: date-time
      - name: unread
        in: query
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - items
                - nextCursor
                - unread
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                      required:
                      - id
                      - type
                      - category
                      - title
                      - body
                      - data
                      - nodeId
                      - createdAt
                      - readAt
                      properties:
                        id:
                          type: string
                        type:
                          type: string
                          description: e.g. memory.highlights.daily, memory.task.due, finance.bill.due.
                        category:
                          type: string
                          enum:
                          - memory
                          - finance
                          - capture
                          - account
                        title:
                          type: string
                        body:
                          type: string
                        data:
                          type: object
                          additionalProperties: true
                          description: 'Deep-link hints: screen (memory, highlights, finance, usage) and id.'
                        nodeId:
                          type:
                          - string
                          - 'null'
                        createdAt:
                          type: string
                          format: date-time
                        readAt:
                          type:
                          - string
                          - 'null'
                          format: date-time
                  nextCursor:
                    type:
                    - string
                    - 'null'
                  unread:
                    type: integer
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    servers:
    - url: https://api.cortexplus.io
  /v1/notifications/unread:
    get:
      operationId: countUnreadNotifications
      summary: Count unread notifications
      x-openai-isConsequential: false
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - unread
                properties:
                  unread:
                    type: integer
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    servers:
    - url: https://api.cortexplus.io
  /v1/notifications/read:
    post:
      operationId: markNotificationsRead
      summary: Mark notifications as read
      description: Mark notifications as read. Requires the cortex.write scope.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - ids
              properties:
                ids:
                  type: array
                  minItems: 1
                  maxItems: 100
                  items:
                    type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - ids
                - unread
                properties:
                  ids:
                    type: array
                    items:
                      type: string
                  unread:
                    type: integer
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    servers:
    - url: https://api.cortexplus.io
  /v1/notifications/read-all:
    post:
      operationId: markAllNotificationsRead
      summary: Mark every notification as read
      description: Mark every notification as read. Requires the cortex.write scope.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - ids
                - unread
                properties:
                  ids:
                    type: array
                    items:
                      type: string
                  unread:
                    type: integer
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    servers:
    - url: https://api.cortexplus.io
  /v1/notifications/archive:
    post:
      operationId: archiveNotifications
      summary: Remove notifications from the inbox
      description: Remove notifications from the inbox. Requires the cortex.write scope.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - ids
              properties:
                ids:
                  type: array
                  minItems: 1
                  maxItems: 100
                  items:
                    type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - ids
                - unread
                properties:
                  ids:
                    type: array
                    items:
                      type: string
                  unread:
                    type: integer
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    servers:
    - url: https://api.cortexplus.io
  /v1/notifications/preferences:
    get:
      operationId: getNotificationPreferences
      summary: Get notification preferences
      x-openai-isConsequential: false
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  categories:
                    type: object
                    description: Per category ({memory, finance, capture, account}) channel switches.
                    additionalProperties:
                      type: object
                      properties:
                        inapp:
                          type: boolean
                        push:
                          type: boolean
                  digest:
                    type: object
                    properties:
                      enabled:
                        type: boolean
                      time:
                        type: string
                        pattern: ^([01]\d|2[0-3]):[0-5]\d$
                  quietHours:
                    type: object
                    properties:
                      enabled:
                        type: boolean
                      start:
                        type: string
                        pattern: ^([01]\d|2[0-3]):[0-5]\d$
                      end:
                        type: string
                        pattern: ^([01]\d|2[0-3]):[0-5]\d$
                  preview:
                    type: string
                    enum:
                    - title
                    - full
                    description: title keeps the memory content off the lock screen.
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    patch:
      operationId: updateNotificationPreferences
      summary: Update notification preferences
      description: Partial merge of the preferences. Requires the cortex.write scope.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                categories:
                  type: object
                  description: Per category ({memory, finance, capture, account}) channel switches.
                  additionalProperties:
                    type: object
                    properties:
                      inapp:
                        type: boolean
                      push:
                        type: boolean
                digest:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                    time:
                      type: string
                      pattern: ^([01]\d|2[0-3]):[0-5]\d$
                quietHours:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                    start:
                      type: string
                      pattern: ^([01]\d|2[0-3]):[0-5]\d$
                    end:
                      type: string
                      pattern: ^([01]\d|2[0-3]):[0-5]\d$
                preview:
                  type: string
                  enum:
                  - title
                  - full
                  description: title keeps the memory content off the lock screen.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  categories:
                    type: object
                    description: Per category ({memory, finance, capture, account}) channel switches.
                    additionalProperties:
                      type: object
                      properties:
                        inapp:
                          type: boolean
                        push:
                          type: boolean
                  digest:
                    type: object
                    properties:
                      enabled:
                        type: boolean
                      time:
                        type: string
                        pattern: ^([01]\d|2[0-3]):[0-5]\d$
                  quietHours:
                    type: object
                    properties:
                      enabled:
                        type: boolean
                      start:
                        type: string
                        pattern: ^([01]\d|2[0-3]):[0-5]\d$
                      end:
                        type: string
                        pattern: ^([01]\d|2[0-3]):[0-5]\d$
                  preview:
                    type: string
                    enum:
                    - title
                    - full
                    description: title keeps the memory content off the lock screen.
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    servers:
    - url: https://api.cortexplus.io
  /v1/notifications/push:
    get:
      operationId: getPushConfig
      summary: Which push providers are configured on the server
      x-openai-isConsequential: false
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - fcm
                - webpush
                - vapidPublicKey
                properties:
                  fcm:
                    type: boolean
                  webpush:
                    type: boolean
                  vapidPublicKey:
                    type:
                    - string
                    - 'null'
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    put:
      operationId: registerPushTarget
      summary: Register this device for push
      description: fcm needs pushToken (the Firebase registration token); webpush needs the browser subscription. With a device token the target is removed when the device is revoked. Requires the cortex.write scope.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - provider
              properties:
                provider:
                  type: string
                  enum:
                  - fcm
                  - webpush
                pushToken:
                  type: string
                  maxLength: 4096
                subscription:
                  type: object
                  additionalProperties: true
                platform:
                  type: string
                  description: e.g. android, ios, web.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    delete:
      operationId: unregisterPushTarget
      summary: Stop push to a token or endpoint
      description: Requires the cortex.write scope.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                pushToken:
                  type: string
                endpoint:
                  type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                required:
                - removed
                properties:
                  removed:
                    type: boolean
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    servers:
    - url: https://api.cortexplus.io
  /v1/notifications/test:
    post:
      operationId: sendTestNotification
      summary: Send a test notification
      description: Create a test notification in the inbox and push it. Requires the cortex.write scope.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        default:
          description: Request failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  field:
                    type: string
                required:
                - error
      tags:
      - Notifications
    servers:
    - url: https://api.cortexplus.io
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
x-refined-from:
- cortexplus-io-openapi.json
- cortexplus-io-openapi.yml