CESNET

CESNET Notification Manager API

NotificationManager RPC API in Perun

GitHub OpenAPI

Operations 23

POST /json/notificationManager/createPerunNotifTemplate Creates a new PerunNotifTemplate and saves all relations #
GET /urlinjsonout/notificationManager/getPerunNotifTemplateById Gets perunNotifTemplate by id #
POST /json/notificationManager/updatePerunNotifTemplate Updates an existing PerunNotifTemplate #
POST /urlinjsonout/notificationManager/removePerunNotifTemplateById Removes a PerunNotifTemplate by id #
GET /urlinjsonout/notificationManager/getAllPerunNotifTemplates Returns all PerunNotifTemplates #
GET /urlinjsonout/notificationManager/getAllPerunNotifRegexes Returns all PerunNotifRegexes #
POST /json/notificationManager/createPerunNotifRegex Saves perunNotifRegex to DB and creates id, also saves relation between regex… #
GET /urlinjsonout/notificationManager/getPerunNotifRegexById Gets perunNotifRegex by id #
POST /json/notificationManager/updatePerunNotifRegex Updates an existing PerunNotifRegex #
POST /urlinjsonout/notificationManager/removePerunNotifRegexById Removes a PerunNotifRegex by id #
POST /urlinjsonout/notificationManager/saveTemplateRegexRelation Stores relation between template and regex to db #
POST /urlinjsonout/notificationManager/removePerunNotifTemplateRegexRelation Removes relation between template and regex #
GET /urlinjsonout/notificationManager/getRelatedRegexesForTemplate Returns all regexes related to given template #
GET /urlinjsonout/notificationManager/getAllPerunNotifReceivers Returns all PerunNotifReceivers #
POST /json/notificationManager/createPerunNotifReceiver Creates perunNotifReceiver with new id #
GET /urlinjsonout/notificationManager/getPerunNotifReceiverById Gets perunNotifReceiver by id #
POST /json/notificationManager/updatePerunNotifReceiver Updates an existing PerunNotifReceiver #
POST /urlinjsonout/notificationManager/removePerunNotifReceiverById Removes a PerunNotifReceiver by id #
GET /urlinjsonout/notificationManager/getAllPerunNotifTemplateMessages Returns all PerunNotifTemplateMessages #
POST /json/notificationManager/createPerunNotifTemplateMessage Save perunNotifTemplateMessage to db #
GET /urlinjsonout/notificationManager/getPerunNotifTemplateMessageById Gets perunNotifTemplateMessage by id #
POST /json/notificationManager/updatePerunNotifTemplateMessage Updates perunNotifTemplateMessage in db #
POST /urlinjsonout/notificationManager/removePerunNotifTemplateMessage Remove perunNotifTemplateMessage from db by id #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/cesnet/openapi/cesnet-notificationmanager-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/CESNET/perun
📦
GitHubRepository
https://github.com/CESNET/exafs

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/cesnet/json-schema/cesnet-application-form-item-schema.json
📊
JSONSchema
https://artifacts.apis.io/cesnet/json-schema/cesnet-perun-notif-template-schema.json
📊
JSONSchema
https://artifacts.apis.io/cesnet/json-schema/cesnet-application-schema.json
📊
JSONSchema
https://artifacts.apis.io/cesnet/json-schema/cesnet-registrar-application-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/cesnet/json-schema/cesnet-applications-page-query-schema.json
📊
JSONSchema
https://artifacts.apis.io/cesnet/json-schema/cesnet-publication-schema.json

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/cesnet:cesnet-notificationmanager-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

cesnet-notificationmanager-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 0.0.0
  title: Perun RPC Notification Manager API
  description: Perun Remote Procedure Calls Application Programming Interface
  contact:
    url: https://perun-aai.org
    email: perun@cesnet.cz
servers:
- url: https://{server}/{authentication}/rpc
  description: Perun RPC server
  variables:
    server:
      default: api-dev.perun-aai.org
      description: DNS name of a Perun server
    authentication:
      default: ba
      description: 'way of authentication:

        ba - HTTP Basic Auth

        krb - Kerberos

        non - no authentication

        cert - X509 client certificate

        oauth - OAuth 2.0 bearer access token

        fed - SAML federation

        '
      enum:
      - ba
      - krb
      - non
      - cert
      - oauth
      - fed
security:
- BasicAuth: []
- BearerAuth: []
tags:
- name: NotificationManager
  description: NotificationManager RPC API in Perun
  externalDocs:
    url: https://perun-aai.org/documentation/technical-documentation/rpc-api/rpc-javadoc-NotificationManager.html
paths:
  /json/notificationManager/createPerunNotifTemplate:
    post:
      tags:
      - NotificationManager
      operationId: createPerunNotifTemplate
      summary: Creates a new PerunNotifTemplate and saves all relations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PerunNotifTemplate'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifTemplateResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getPerunNotifTemplateById:
    get:
      tags:
      - NotificationManager
      operationId: getPerunNotifTemplateById
      summary: Gets perunNotifTemplate by id
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifTemplateResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /json/notificationManager/updatePerunNotifTemplate:
    post:
      tags:
      - NotificationManager
      operationId: updatePerunNotifTemplate
      summary: Updates an existing PerunNotifTemplate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PerunNotifTemplate'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifTemplateResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/removePerunNotifTemplateById:
    post:
      tags:
      - NotificationManager
      operationId: removePerunNotifTemplateById
      summary: Removes a PerunNotifTemplate by id
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/VoidResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getAllPerunNotifTemplates:
    get:
      tags:
      - NotificationManager
      operationId: getAllPerunNotifTemplates
      summary: Returns all PerunNotifTemplates
      responses:
        '200':
          description: returns List<PerunNotifTemplate>
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerunNotifTemplate'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getAllPerunNotifRegexes:
    get:
      tags:
      - NotificationManager
      operationId: getAllPerunNotifRegexes
      summary: Returns all PerunNotifRegexes
      responses:
        '200':
          description: returns List<PerunNotifRegex>
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerunNotifRegex'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /json/notificationManager/createPerunNotifRegex:
    post:
      tags:
      - NotificationManager
      operationId: createPerunNotifRegex
      summary: Saves perunNotifRegex to DB and creates id, also saves relation between regex…
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                regex:
                  $ref: '#/components/schemas/PerunNotifRegex'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifRegexResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getPerunNotifRegexById:
    get:
      tags:
      - NotificationManager
      operationId: getPerunNotifRegexById
      summary: Gets perunNotifRegex by id
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifRegexResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /json/notificationManager/updatePerunNotifRegex:
    post:
      tags:
      - NotificationManager
      operationId: updatePerunNotifRegex
      summary: Updates an existing PerunNotifRegex
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                regex:
                  $ref: '#/components/schemas/PerunNotifRegex'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifRegexResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/removePerunNotifRegexById:
    post:
      tags:
      - NotificationManager
      operationId: removePerunNotifRegexById
      summary: Removes a PerunNotifRegex by id
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/VoidResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/saveTemplateRegexRelation:
    post:
      tags:
      - NotificationManager
      operationId: saveTemplateRegexRelation
      summary: Stores relation between template and regex to db
      parameters:
      - name: templateId
        description: Id of the Notif Template
        schema:
          type: integer
        in: query
        required: true
      - name: regexId
        description: Id of the Notif Regex
        schema:
          type: integer
        in: query
        required: true
      responses:
        '200':
          $ref: '#/components/responses/VoidResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/removePerunNotifTemplateRegexRelation:
    post:
      tags:
      - NotificationManager
      operationId: removePerunNotifTemplateRegexRelation
      summary: Removes relation between template and regex
      parameters:
      - name: templateId
        description: Id of the Notif Template
        schema:
          type: integer
        in: query
        required: true
      - name: regexId
        description: Id of the Notif Regex
        schema:
          type: integer
        in: query
        required: true
      responses:
        '200':
          $ref: '#/components/responses/VoidResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getRelatedRegexesForTemplate:
    get:
      tags:
      - NotificationManager
      operationId: getRelatedRegexesForTemplate
      summary: Returns all regexes related to given template
      parameters:
      - name: templateId
        description: Id of the Notif Template
        schema:
          type: integer
        in: query
        required: true
      responses:
        '200':
          description: returns List<PerunNotifRegex>
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerunNotifRegex'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getAllPerunNotifReceivers:
    get:
      tags:
      - NotificationManager
      operationId: getAllPerunNotifReceivers
      summary: Returns all PerunNotifReceivers
      responses:
        '200':
          description: returns List<PerunNotifReceiver>
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerunNotifReceiver'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /json/notificationManager/createPerunNotifReceiver:
    post:
      tags:
      - NotificationManager
      operationId: createPerunNotifReceiver
      summary: Creates perunNotifReceiver with new id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                receiver:
                  $ref: '#/components/schemas/PerunNotifReceiver'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifReceiverResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getPerunNotifReceiverById:
    get:
      tags:
      - NotificationManager
      operationId: getPerunNotifReceiverById
      summary: Gets perunNotifReceiver by id
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifReceiverResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /json/notificationManager/updatePerunNotifReceiver:
    post:
      tags:
      - NotificationManager
      operationId: updatePerunNotifReceiver
      summary: Updates an existing PerunNotifReceiver
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                receiver:
                  $ref: '#/components/schemas/PerunNotifReceiver'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifReceiverResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/removePerunNotifReceiverById:
    post:
      tags:
      - NotificationManager
      operationId: removePerunNotifReceiverById
      summary: Removes a PerunNotifReceiver by id
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/VoidResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getAllPerunNotifTemplateMessages:
    get:
      tags:
      - NotificationManager
      operationId: getAllPerunNotifTemplateMessages
      summary: Returns all PerunNotifTemplateMessages
      responses:
        '200':
          description: returns List<PerunNotifTemplateMessage>
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PerunNotifTemplateMessage'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /json/notificationManager/createPerunNotifTemplateMessage:
    post:
      tags:
      - NotificationManager
      operationId: createPerunNotifTemplateMessage
      summary: Save perunNotifTemplateMessage to db
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  $ref: '#/components/schemas/PerunNotifTemplateMessage'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifTemplateMessageResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/getPerunNotifTemplateMessageById:
    get:
      tags:
      - NotificationManager
      operationId: getPerunNotifTemplateMessageById
      summary: Gets perunNotifTemplateMessage by id
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifTemplateMessageResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /json/notificationManager/updatePerunNotifTemplateMessage:
    post:
      tags:
      - NotificationManager
      operationId: updatePerunNotifTemplateMessage
      summary: Updates perunNotifTemplateMessage in db
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  $ref: '#/components/schemas/PerunNotifTemplateMessage'
      responses:
        '200':
          $ref: '#/components/responses/PerunNotifTemplateMessageResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
  /urlinjsonout/notificationManager/removePerunNotifTemplateMessage:
    post:
      tags:
      - NotificationManager
      operationId: removePerunNotifTemplateMessage
      summary: Remove perunNotifTemplateMessage from db by id
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          $ref: '#/components/responses/VoidResponse'
        default:
          $ref: '#/components/responses/ExceptionResponse'
components:
  responses:
    PerunNotifTemplateMessageResponse:
      description: returns PerunNotifTemplateMessage
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PerunNotifTemplateMessage'
    VoidResponse:
      description: returns nothing
    ExceptionResponse:
      description: exception occurred
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PerunException'
    PerunNotifRegexResponse:
      description: returns PerunNotifRegex
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PerunNotifRegex'
    PerunNotifTemplateResponse:
      description: returns PerunNotifTemplate
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PerunNotifTemplate'
    PerunNotifReceiverResponse:
      description: returns PerunNotifReceiver
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PerunNotifReceiver'
  parameters:
    id:
      name: id
      description: numeric id
      schema:
        type: integer
      in: query
      required: true
  schemas:
    PerunException:
      description: exception thrown from inside of Perun
      type: object
      properties:
        errorId:
          type: string
        name:
          type: string
        message:
          type: string
    PerunNotifTemplateMessage:
      description: Localized freemarker template
      type: object
      properties:
        id:
          type: integer
        templateId:
          type: integer
        locale:
          type: string
        message:
          type:
          - string
          - 'null'
        subject:
          type: string
    PerunNotifObject:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        properties:
          type: array
          items:
            type: string
        objectClass:
          type: string
    PerunNotifRegex:
      description: Holds a regex definition used to recognize type of message
      type: object
      properties:
        id:
          type: integer
        regex:
          type: string
        note:
          type:
          - string
          - 'null'
        objects:
          type: array
          items:
            $ref: '#/components/schemas/PerunNotifObject'
    PerunNotifReceiver:
      description: Represents one receiver of message, is defined in template
      type: object
      properties:
        id:
          type: integer
        target:
          type: string
        typeOfReceiver:
          type: string
        templateId:
          type: integer
        locale:
          type:
          - string
          - 'null'
    PerunNotifTemplate:
      description: Represents template for message sent to receivers
      type: object
      properties:
        id:
          type: integer
        name:
          type:
          - string
          - 'null'
        matchingRegexs:
          type: array
          items:
            $ref: '#/components/schemas/PerunNotifRegex'
        receivers:
          type: array
          items:
            $ref: '#/components/schemas/PerunNotifReceiver'
        primaryProperties:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
        notifyTrigger:
          type: string
        perunNotifTemplateMessages:
          type: array
          items:
            $ref: '#/components/schemas/PerunNotifTemplateMessage'
        oldestMessageTime:
          type:
          - integer
          - 'null'
          format: int64
        youngestMessageTime:
          type:
          - integer
          - 'null'
          format: int64
        sender:
          type:
          - string
          - 'null'
        replyTo:
          type:
          - string
          - 'null'
  securitySchemes:
    BasicAuth:
      description: HTTP Basic authentication with username and password
      type: http
      scheme: basic
    BearerAuth:
      description: 'OAuth2 Resource Server authentication using access token in ''Authorization: Bearer'' HTTP header'
      type: http
      scheme: bearer