Mechanism for SOF to publish *Service* notifications to BUS
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mef-event-listeners-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: Mef Event listeners API
version: '1.0'
description: 'Operations tagged Event listeners across 3 of this provider''s published API definitions: mef-lso-allegro-service-inventory-notification-openapi.yml, mef-lso-interlude-service-inventory-notification-openapi.yml, mef-lso-legato-service-inventory-notification-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{serverBase}/mefApi/allegro/serviceInventoryNotification/v2/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
- url: https://{serverBase}/mefApi/interlude/serviceInventoryNotification/v2/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
- url: https://{serverBase}/mefApi/legato/serviceInventoryNotification/v7/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
tags:
- name: Event listeners
description: Mechanism for SOF to publish *Service* notifications to BUS
paths:
/listener/serviceCreateEvent:
post:
tags:
- Event listeners
summary: Service Create Event endpoint
description: This endpoint is used to receive notifications on Service Create Events
operationId: ServiceCreateEvent
requestBody:
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/ServiceCreateEvent'
required: true
responses:
'204':
description: No Content (https://tools.ietf.org/html/rfc7231#section-6.3.5)
'400':
description: Bad Request
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
'401':
description: Unauthorized
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
'403':
description: Forbidden
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
'500':
description: Internal Server Error
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
servers:
- url: https://{serverBase}/mefApi/allegro/serviceInventoryNotification/v2/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
/listener/serviceDeleteEvent:
post:
tags:
- Event listeners
summary: Service Delete Event endpoint
description: This endpoint is used to receive notifications on Service Delete Events
operationId: serviceDeleteEvent
requestBody:
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/ServiceDeleteEvent'
required: true
responses:
'204':
description: No Content (https://tools.ietf.org/html/rfc7231#section-6.3.5)
'400':
description: Bad Request
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
'401':
description: Unauthorized
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
'403':
description: Forbidden
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
'500':
description: Internal Server Error
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
servers:
- url: https://{serverBase}/mefApi/allegro/serviceInventoryNotification/v2/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
/listener/serviceStateChangeEvent:
post:
tags:
- Event listeners
summary: Service State Change Event endpoint
description: This endpoint is used to receive notifications on Service State Change Events
operationId: serviceStateChangeEvent
requestBody:
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/ServiceStateChangeEvent'
required: true
responses:
'204':
description: No Content (https://tools.ietf.org/html/rfc7231#section-6.3.5)
'400':
description: Bad Request
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
'401':
description: Unauthorized
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
'403':
description: Forbidden
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
'500':
description: Internal Server Error
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
servers:
- url: https://{serverBase}/mefApi/allegro/serviceInventoryNotification/v2/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
/listener/serviceAttributeValueChangeEvent:
post:
tags:
- Event listeners
summary: Service Attribute Value Change Event endpoint
description: This endpoint is used to receive notifications on Service Attribute Value Change Events
operationId: serviceAttributeValueChangeEvent
requestBody:
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/ServiceAttributeValueChangeEvent'
required: true
responses:
'204':
description: No Content (https://tools.ietf.org/html/rfc7231#section-6.3.5)
'400':
description: Bad Request
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
'401':
description: Unauthorized
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
'403':
description: Forbidden
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
'500':
description: Internal Server Error
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
servers:
- url: https://{serverBase}/mefApi/allegro/serviceInventoryNotification/v2/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
components:
schemas:
Error400Code:
description: 'One of the following error codes:
- missingQueryParameter: The URI is missing a required query-string parameter
- missingQueryValue: The URI is missing a required query-string parameter value
- invalidQuery: The query section of the URI is invalid.
- invalidBody: The request has an invalid body'
type: string
enum:
- missingQueryParameter
- missingQueryValue
- invalidQuery
- invalidBody
ServiceAttributeValueChangeEvent:
allOf:
- $ref: '#/components/schemas/Event'
- type: object
properties:
eventType:
description: 'Indicates the type of the event.
'
type: string
enum:
- serviceAttributeValueChangeEvent
event:
description: 'A reference to the object that is source of the notification.
'
$ref: '#/components/schemas/ServiceEventPayload'
required:
- event
- eventType
ServiceEventPayload:
description: The identifier of the Service being subject of this event.
type: object
properties:
id:
description: ID of the Service
type: string
href:
description: Hyperlink to access the Service
type: string
required:
- id
ServiceStateType:
description: 'Valid values for the lifecycle state of the Service.
| State | Description |
| ------------------ | --------------------------------------------------------------------------------------------------------------------- |
| feasibilityChecked | Initial check whether the necessary resources are available and sufficient for the installation of a given service. |
| designed | The Service is designed. The resources are identified and/or allocated, but not reserved. |
| reserved | All required resources for given service are reserved and ready. |
| inactive | The service is deactivated and is no longer available. |
| active | The service is fully available and active |
| terminated | The service is ''logically deleted''. All associated resources are freed and made available for service to other users. |
'
type: string
enum:
- feasibilityChecked
- designed
- reserved
- inactive
- active
- terminated
ServiceStateChangeEventPayload:
description: The identifier of the Service being subject of this event.
type: object
properties:
id:
description: ID of the Service
type: string
href:
description: Hyperlink to access the Service
type: string
state:
description: The life cycle state of the service.
$ref: '#/components/schemas/ServiceStateType'
required:
- id
- state
ServiceStateChangeEvent:
allOf:
- $ref: '#/components/schemas/Event'
- type: object
properties:
eventType:
description: 'Indicates the type of the event.
'
type: string
enum:
- serviceStateChangeEvent
event:
description: 'A reference to the object that is source of the notification.
'
$ref: '#/components/schemas/ServiceStateChangeEventPayload'
required:
- event
- eventType
Error403:
description: Forbidden. (https://tools.ietf.org/html/rfc7231#section-6.5.3)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'This code indicates that the server understood
the request but refuses to authorize it because
of one of the following error codes:
- accessDenied: Access denied
- forbiddenRequester: Forbidden requester
- tooManyUsers: Too many users'
$ref: '#/components/schemas/Error403Code'
required:
- code
ServiceCreateEvent:
allOf:
- $ref: '#/components/schemas/Event'
- type: object
properties:
eventType:
description: 'Indicates the type of the event.
'
type: string
enum:
- serviceCreateEvent
event:
description: 'A reference to the object that is source of the notification.
'
$ref: '#/components/schemas/ServiceEventPayload'
required:
- event
- eventType
Event:
description: Event class is used to describe information structure used for notification.
type: object
properties:
eventId:
description: Id of the event
type: string
eventTime:
description: Date-time when the event occurred
type: string
format: date-time
eventType:
description: The type of the notification.
type: string
event:
description: The event linked to the involved resource object
type: object
required:
- event
- eventId
- eventTime
- eventType
Error401:
description: Unauthorized. (https://tools.ietf.org/html/rfc7235#section-3.1)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'One of the following error codes:
- missingCredentials: No credentials provided.
- invalidCredentials: Provided credentials are invalid or expired'
$ref: '#/components/schemas/Error401Code'
required:
- code
ServiceDeleteEvent:
allOf:
- $ref: '#/components/schemas/Event'
- type: object
properties:
eventType:
description: 'Indicates the type of the event.
'
type: string
enum:
- serviceDeleteEvent
event:
description: 'A reference to the object that is source of the notification.
'
$ref: '#/components/schemas/ServiceEventPayload'
required:
- event
- eventType
Error401Code:
description: 'One of the following error codes:
- missingCredentials: No credentials provided.
- invalidCredentials: Provided credentials are invalid or expired'
type: string
enum:
- missingCredentials
- invalidCredentials
Error400:
description: Bad Request. (https://tools.ietf.org/html/rfc7231#section-6.5.1)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'One of the following error codes:
- missingQueryParameter: The URI is missing a required query-string parameter
- missingQueryValue: The URI is missing a required query-string parameter value
- invalidQuery: The query section of the URI is invalid.
- invalidBody: The request has an invalid body'
$ref: '#/components/schemas/Error400Code'
required:
- code
Error500:
description: Internal Server Error. (https://tools.ietf.org/html/rfc7231#section-6.6.1)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'One of the following error codes:
- internalError: Internal server error - the server encountered an unexpected condition that prevented it from fulfilling the request.'
type: string
enum:
- internalError
required:
- code
Error403Code:
description: 'This code indicates that the server understood
the request but refuses to authorize it because
of one of the following error codes:
- accessDenied: Access denied
- forbiddenRequester: Forbidden requester
- tooManyUsers: Too many users'
type: string
enum:
- accessDenied
- forbiddenRequester
- tooManyUsers
Error:
description: 'Standard Class used to describe API response error
Not intended to be use directly. The `code` in the HTTP header is used as a discriminator for the type of error returned in runtime.
'
type: object
properties:
reason:
description: Text that explains the reason for error. This can be shown to a client user.
type: string
maxLength: 255
message:
description: Text that provide mode details and corrective actions related to the error. This can be shown to a client user.
type: string
referenceError:
description: url pointing to documentation describing the error
type: string
format: uri
required:
- reason
x-refined-from:
- mef-lso-allegro-service-inventory-notification-openapi.yml
- mef-lso-interlude-service-inventory-notification-openapi.yml
- mef-lso-legato-service-inventory-notification-openapi.yml