Progress Software Notifications API

The Notifications API from Progress Software — 4 operation(s) for notifications.

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v0/notifications/rules List notification rules · Notifications list rules #
Ask an LLM
“What notification rules are set up in Chef Automate?”
“Which alerts are configured to fire?”
Tell an agent
List all notification rules.
Show me every configured alert rule.
POST /api/v0/notifications/rules Create a notification rule · Notifications add rule #
Ask an LLM
“How do I set up a notification for failed runs or compliance failures?”
“Can I add a new alert rule that posts to a webhook?”
Tell an agent
Create notification rule {rule}.
Add a new alert rule defined as {rule}.
GET /api/v0/notifications/rules/{id} Get a notification rule · Notifications get rule #
Ask an LLM
“What does a specific notification rule do?”
“Can I see one alert rule's target and event?”
Tell an agent
Show notification rule {id}.
Get details of alert rule {id}.
PUT /api/v0/notifications/rules/{id} Update a notification rule · Notifications update rule #
Ask an LLM
“How do I change an existing notification rule?”
“Can I edit the destination of an alert rule I already created?”
Tell an agent
Update notification rule {id} to {rule}.
Change existing alert rule {id}.
DELETE /api/v0/notifications/rules/{id} Delete a notification rule · Notifications delete rule #
Ask an LLM
“How do I stop an alert from firing permanently?”
“Can I remove a notification rule?”
Tell an agent destructive · confirm first
Delete notification rule {id}.
Remove alert rule {id}.
GET /api/v0/notifications/version Get the notifications service version · Notifications version #
Ask an LLM
“What version of the notifications service is running?”
“Is the notifications service up and reporting its version?”
Tell an agent
Get the notifications service version.
Check which notifications service build is deployed.
POST /api/v0/notifications/webhook Test a notification webhook · Notifications validate webhook #
Ask an LLM
“Can I check that a webhook URL works before using it in a rule?”
“How do I validate a webhook that needs basic auth or a stored secret?”
Tell an agent
Validate webhook {url}.
Test webhook {url} using secret {secret_id}.

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/progress-software:progress-software-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.

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

OpenAPI Specification

progress-software-notifications-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: '# Authentication

    The Chef Automate API typically uses an API token passed in the header of your API request.'
  title: Chef Automate API Documentation Notifications API
  termsOfService: https://www.chef.io/terms-and-conditions-of-use/
  contact:
    url: https://www.chef.io/support/
    email: support@chef.io
  license:
    name: Apache 2.0
    url: https://github.com/chef/automate/blob/main/LICENSE
  version: version not set
  x-logo:
    altText: Chef logo
    url: /images/chef-automate-logo.svg
servers:
- url: https://automate.chef.io
tags:
- name: Notifications
  x-displayName: Notifications
paths:
  /api/v0/notifications/rules:
    get:
      tags:
      - Notifications
      operationId: Notifications_ListRules
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.notifications.RuleListResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      summary: Notifications list rules
      x-summary-source: derived
    post:
      tags:
      - Notifications
      operationId: Notifications_AddRule
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.notifications.RuleAddResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/chef.automate.api.notifications.RuleAddRequest'
        required: true
      summary: Notifications add rule
      x-summary-source: derived
  /api/v0/notifications/rules/{id}:
    get:
      tags:
      - Notifications
      operationId: Notifications_GetRule
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.notifications.RuleGetResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      summary: Notifications get rule
      x-summary-source: derived
    put:
      tags:
      - Notifications
      operationId: Notifications_UpdateRule
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.notifications.RuleUpdateResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/chef.automate.api.notifications.RuleUpdateRequest'
        required: true
      summary: Notifications update rule
      x-summary-source: derived
    delete:
      tags:
      - Notifications
      operationId: Notifications_DeleteRule
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.notifications.RuleDeleteResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      summary: Notifications delete rule
      x-summary-source: derived
  /api/v0/notifications/version:
    get:
      tags:
      - Notifications
      operationId: Notifications_Version
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.notifications.VersionResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      summary: Notifications version
      x-summary-source: derived
  /api/v0/notifications/webhook:
    post:
      tags:
      - Notifications
      operationId: Notifications_ValidateWebhook
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/chef.automate.api.notifications.URLValidationResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/grpc.gateway.runtime.Error'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/chef.automate.api.notifications.URLValidationRequest'
        required: true
      summary: Notifications validate webhook
      x-summary-source: derived
components:
  schemas:
    chef.automate.api.notifications.RuleGetResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            type: string
        rule:
          $ref: '#/components/schemas/chef.automate.api.notifications.Rule'
    chef.automate.api.notifications.SecretId:
      type: object
      properties:
        id:
          type: string
    chef.automate.api.notifications.Rule.Event:
      type: string
      default: CCRFailure
      enum:
      - CCRFailure
      - CCRSuccess
      - ComplianceFailure
      - ComplianceSuccess
    chef.automate.api.notifications.Empty:
      type: object
    chef.automate.api.notifications.RuleDeleteResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            type: string
    google.protobuf.Any:
      type: object
      properties:
        type_url:
          type: string
        value:
          type: string
          format: byte
    chef.automate.api.notifications.RuleUpdateResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            type: string
    chef.automate.api.notifications.RuleAddRequest:
      type: object
      properties:
        rule:
          $ref: '#/components/schemas/chef.automate.api.notifications.Rule'
    chef.automate.api.notifications.RuleUpdateRequest:
      type: object
      properties:
        id:
          type: string
        rule:
          $ref: '#/components/schemas/chef.automate.api.notifications.Rule'
    chef.automate.api.notifications.VersionResponse:
      type: object
      properties:
        version:
          type: string
    chef.automate.api.notifications.WebhookAlert:
      type: object
      properties:
        url:
          type: string
    grpc.gateway.runtime.Error:
      type: object
      properties:
        code:
          type: integer
          format: int32
        details:
          type: array
          items:
            $ref: '#/components/schemas/google.protobuf.Any'
        error:
          type: string
        message:
          type: string
    chef.automate.api.notifications.URLValidationResponse:
      type: object
    chef.automate.api.notifications.SlackAlert:
      type: object
      properties:
        url:
          type: string
    chef.automate.api.notifications.RuleAddResponse:
      type: object
      properties:
        id:
          type: string
        messages:
          type: array
          items:
            type: string
        name:
          type: string
        rule:
          $ref: '#/components/schemas/chef.automate.api.notifications.Rule'
    chef.automate.api.notifications.ServiceNowAlert:
      type: object
      properties:
        critical_controls_only:
          type: boolean
        secret_id:
          type: string
        url:
          type: string
    chef.automate.api.notifications.URLValidationRequest:
      type: object
      properties:
        none:
          $ref: '#/components/schemas/chef.automate.api.notifications.Empty'
        secret_id:
          $ref: '#/components/schemas/chef.automate.api.notifications.SecretId'
        url:
          type: string
        username_password:
          $ref: '#/components/schemas/chef.automate.api.notifications.UsernamePassword'
    chef.automate.api.notifications.UsernamePassword:
      type: object
      properties:
        password:
          type: string
        username:
          type: string
    chef.automate.api.notifications.Rule:
      type: object
      properties:
        ServiceNowAlert:
          $ref: '#/components/schemas/chef.automate.api.notifications.ServiceNowAlert'
        SlackAlert:
          $ref: '#/components/schemas/chef.automate.api.notifications.SlackAlert'
        WebhookAlert:
          $ref: '#/components/schemas/chef.automate.api.notifications.WebhookAlert'
        event:
          $ref: '#/components/schemas/chef.automate.api.notifications.Rule.Event'
        id:
          type: string
        name:
          type: string
    chef.automate.api.notifications.RuleListResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            type: string
        rules:
          type: array
          items:
            $ref: '#/components/schemas/chef.automate.api.notifications.Rule'
  securitySchemes:
    APIToken:
      description: Authenticate with the Automate API using an API Token.
      type: apiKey
      name: api-token
      in: header
x-tagGroups:
- name: Compliance
  tags:
  - ReportingService
  - StatsService
  - JobsService
  - ProfilesService
  - Comp_Assets
- name: Report Manager
  tags:
  - ReportManagerService
- name: Infra
  tags:
  - ConfigMgmt
  - InfraProxy
- name: Ingest
  tags:
  - ChefIngester
  - JobScheduler
- name: Node Management
  tags:
  - NodeManagerService
  - NodesService
- name: Event Feed
  tags:
  - EventFeedService
- name: Secrets
  tags:
  - SecretsService
- name: Applications
  tags:
  - service_groups
  - retention
  - ApplicationsService
- name: Data Feed
  tags:
  - DatafeedService
- name: Data Lifecycle
  tags:
  - DataLifecycle
- name: Notifications
  tags:
  - Notifications
- name: Content Delivery
  tags:
  - Cds
- name: Audit and Settings
  tags:
  - UserSettingsService
- name: System
  tags:
  - Gateway
  - Deployment
  - License
  - Telemetry
  - LegacyDataCollector
- name: Identity
  tags:
  - users
  - teams
  - tokens
- name: Access Management
  tags:
  - policies
  - roles
  - projects
  - rules
  - Authorization