Oracle Notification Control Plane API

openapi: 3.2.0
info:
  description: 'Use the Notifications API to broadcast messages to distributed components by topic, using a publish-subscribe pattern.

    For information about managing topics, subscriptions, and messages, see [the Notifications documentation](/iaas/Content/Notification/home.htm).

    '
  title: Notifications Notification Control Plane API
  version: '20181201'
  x-provenance:
    method: harvested
    first_party: true
    publisher: Oracle
    source: https://docs.oracle.com/en-us/iaas/api/specs/14e5a8c24001383732b20453d9b177ede7ed076f9ad3fb4854c8a85494ba67da.yaml
    harvested: '2026-08-04'
    note: Published by Oracle as the contract for the Notifications API OCI service and stored verbatim; API Evangelist added only this provenance block.
  x-evidence:
  - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json
    what: Oracle's own index of every OCI service specification
  - url: https://docs.oracle.com/en-us/iaas/api/specs/14e5a8c24001383732b20453d9b177ede7ed076f9ad3fb4854c8a85494ba67da.yaml
    what: the harvested document for Notifications API
servers:
- url: https://notification.{region}.oraclecloud.com/20181201
tags:
- name: notificationControlPlane
paths:
  /publisherMapGroups:
    get:
      description: 'Lists the publisher map groups in the specified compartment.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: ListPublisherMapGroups
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        200:
          description: The list of publisher map groups.
          headers:
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages of results remain.

                For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/PublisherMapGroupSummary'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMapGroup'
    post:
      description: 'Creates a publisher map group.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: CreatePublisherMapGroup
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/SplatGeneratedResourceId'
      responses:
        200:
          description: Created
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMapGroup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMapGroup'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePublisherMapGroupDetails'
        description: The publisher map group to create.
        required: true
  /publisherMapGroups/{publisherMapGroupId}:
    delete:
      description: 'Deletes the specified publisher map group.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: DeletePublisherMapGroup
      parameters:
      - description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the publisher map group to delete.

          '
        in: path
        name: publisherMapGroupId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/OverrideLocksQueryParameter'
      responses:
        204:
          description: Deleted
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMapGroup'
    get:
      description: 'Gets the specified publisher map group''s configuration information.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: GetPublisherMapGroup
      parameters:
      - description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the publisher map group to retrieve.

          '
        in: path
        name: publisherMapGroupId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        200:
          description: Success
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMapGroup'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMapGroup'
    put:
      description: 'Updates the specified PublisherMapGroup''s configuration.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: UpdatePublisherMapGroup
      parameters:
      - description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the publisher map group to update.

          '
        in: path
        name: publisherMapGroupId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/SplatStoreRequestToken'
      - $ref: '#/components/parameters/OverrideLocksQueryParameter'
      responses:
        200:
          description: Publisher map group updated
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMapGroup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-example: 'PUT /20181201/publisherMapGroups/<var>&lt;publisherMapGroup_OCID&gt;</var>

        Host: notification.us-phoenix-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/PublisherMapGroup'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePublisherMapGroupDetails'
        description: entity of details passed in to update PublisherMapGroup
        required: true
  /publisherMapGroups/{publisherMapGroupId}/actions/addLock:
    post:
      description: Adds a lock to a PublisherMapGroup resource.
      operationId: AddPublisherMapGroupLock
      parameters:
      - description: 'Unique identifier for the request.

          If you need to contact Oracle about a particular request, please provide the request ID.

          '
        in: header
        name: opc-request-id
        required: false
        schema:
          type: string
      - description: 'For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`

          parameter to the value of the etag from a previous GET or POST response for that resource. The resource

          will be updated or deleted only if the etag you provide matches the resource''s current etag value.

          '
        in: header
        name: if-match
        schema:
          type: string
      - $ref: '#/components/parameters/PublisherMapGroupIdPathParam'
      - $ref: '#/components/parameters/AddResourceLockDetailsBodyParam'
      responses:
        200:
          description: Lock is added.
          headers:
            etag:
              description: 'etag for the returned PublisherMapGroup resource.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMapGroup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Adds a lock to a PublisherMapGroup resource.
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMapGroup'
  /publisherMapGroups/{publisherMapGroupId}/actions/removeLock:
    post:
      description: Removes a lock from a PublisherMapGroup resource.
      operationId: RemovePublisherMapGroupLock
      parameters:
      - description: 'Unique identifier for the request.

          If you need to contact Oracle about a particular request, please provide the request ID.

          '
        in: header
        name: opc-request-id
        required: false
        schema:
          type: string
      - description: 'For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`

          parameter to the value of the etag from a previous GET or POST response for that resource. The resource

          will be updated or deleted only if the etag you provide matches the resource''s current etag value.

          '
        in: header
        name: if-match
        schema:
          type: string
      - $ref: '#/components/parameters/PublisherMapGroupIdPathParam'
      - $ref: '#/components/parameters/RemoveResourceLockDetailsBodyParam'
      responses:
        200:
          description: Lock is removed.
          headers:
            etag:
              description: 'etag for the returned PublisherMapGroup resource.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMapGroup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Removes a lock to a PublisherMapGroup resource.
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMapGroup'
  /publisherMaps:
    get:
      description: 'Lists the publisher maps in the specified compartment.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: ListPublisherMaps
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        200:
          description: The list of publisher maps.
          headers:
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages of results remain.

                For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/PublisherMapSummary'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMap'
    post:
      description: 'Creates a publisher map.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: CreatePublisherMap
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/SplatGeneratedResourceId'
      responses:
        200:
          description: Created
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMap'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMap'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePublisherMapDetails'
        description: The publisher map to create.
        required: true
  /publisherMaps/{publisherMapId}:
    delete:
      description: 'Deletes the specified publisher map.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: DeletePublisherMap
      parameters:
      - description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the publisher map to delete.

          '
        in: path
        name: publisherMapId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/OverrideLocksQueryParameter'
      responses:
        204:
          description: Deleted
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMap'
    get:
      description: 'Gets the specified publisher map''s configuration information.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: GetPublisherMap
      parameters:
      - description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the publisher map to retrieve.

          '
        in: path
        name: publisherMapId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        200:
          description: Success
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMap'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMap'
    put:
      description: 'Updates the specified PublisherMap''s configuration.


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

        '
      operationId: UpdatePublisherMap
      parameters:
      - description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the publisher map to update.

          '
        in: path
        name: publisherMapId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/SplatStoreRequestToken'
      - $ref: '#/components/parameters/OverrideLocksQueryParameter'
      responses:
        200:
          description: Publisher map updated
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMap'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-example: 'PUT /20181201/publisherMaps/<var>&lt;publisherMap_OCID&gt;</var>

        Host: notification.us-phoenix-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/PublisherMap'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePublisherMapDetails'
        description: entity of details passed in to update PublisherMap
        required: true
  /publisherMaps/{publisherMapId}/actions/addLock:
    post:
      description: Adds a lock to a PublisherMap resource.
      operationId: AddPublisherMapLock
      parameters:
      - description: 'Unique identifier for the request.

          If you need to contact Oracle about a particular request, please provide the request ID.

          '
        in: header
        name: opc-request-id
        required: false
        schema:
          type: string
      - description: 'For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`

          parameter to the value of the etag from a previous GET or POST response for that resource. The resource

          will be updated or deleted only if the etag you provide matches the resource''s current etag value.

          '
        in: header
        name: if-match
        schema:
          type: string
      - $ref: '#/components/parameters/PublisherMapIdPathParam'
      - $ref: '#/components/parameters/AddResourceLockDetailsBodyParam'
      responses:
        200:
          description: Lock is added.
          headers:
            etag:
              description: 'etag for the returned PublisherMap resource.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMap'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Adds a lock to a PublisherMap resource.
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMap'
  /publisherMaps/{publisherMapId}/actions/removeLock:
    post:
      description: Removes a lock from a PublisherMap resource.
      operationId: RemovePublisherMapLock
      parameters:
      - description: 'Unique identifier for the request.

          If you need to contact Oracle about a particular request, please provide the request ID.

          '
        in: header
        name: opc-request-id
        required: false
        schema:
          type: string
      - description: 'For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`

          parameter to the value of the etag from a previous GET or POST response for that resource. The resource

          will be updated or deleted only if the etag you provide matches the resource''s current etag value.

          '
        in: header
        name: if-match
        schema:
          type: string
      - $ref: '#/components/parameters/PublisherMapIdPathParam'
      - $ref: '#/components/parameters/RemoveResourceLockDetailsBodyParam'
      responses:
        200:
          description: Lock is removed.
          headers:
            etag:
              description: 'etag for the returned PublisherMap resource.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublisherMap'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Removes a lock to a PublisherMap resource.
      tags:
      - notificationControlPlane
      x-related-resource: '#/definitions/PublisherMap'
  /topics:
    get:
      description: 'Lists topics in the specified compartment.

        For instructions, see

        [Listing Topics](/iaas/Content/Notification/Tasks/list-topic.htm).


        Transactions Per Minute (TPM) per-tenancy limit for this operation: 120.

        '
      operationId: ListTopics
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/FilterByIdQueryParam'
      - $ref: '#/components/parameters/FilterByNameQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/SortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - description: 'Filter returned list by specified lifecycle state. This parameter is case-insensitive.

          '
        in: query
        name: lifecycleState
        required: false
        x-obmcs-enumref: '#/definitions/NotificationTopicSummary/lifecycleState'
        schema:
          type: string
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/OciNapCorpNetworkHeaderParam'
      responses:
        200:
          description: The list of topics.
          headers:
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages of results remain.

                For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-previous-page:
              description: 'For list pagination. When this header appears in the response, previous pages of results remain.

                For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/NotificationTopicSummary'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
      - notificationControlPlane
      x-example: 'Sample 1: List all topics in a compartment, sorted by lifecycle state


        GET /20181201/topics?compartmentId=<var>&lt;compartment_OCID&gt;</var>&sortBy="LIFECYCLESTATE"

        Host: notification.us-phoenix-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>


        Sample 2: List the topic named "MessageMonitoring" in a compartment


        GET /20181201/topics?compartmentId=<var>&lt;compartment_OCID&gt;</var>&name="MessageMonitoring"

        Host: notification.us-phoenix-1.oci.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/NotificationTopic'
    post:
      description: 'Creates a topic in the specified compartment.

        For instructions, see

        [Creating a Topic](/iaas/Content/Notification/Tasks/create-topic.htm).


        For the purposes of access contro

# --- truncated at 32 KB (94 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle/refs/heads/main/openapi/oracle-notificationcontrolplane-api-openapi.yml