SAP Integration Suite Message Processing Logs API

openapi: 3.2.0
info:
  title: SAP Cloud Integration Message Processing Logs API
  description: The SAP Cloud Integration API (Process Integration Runtime API) provides OData V2 and REST endpoints for deploying, monitoring, and managing integration flows, artifacts, packages, and runtime operations on SAP Integration Suite hosted on SAP Business Technology Platform. It supports message processing log retrieval, integration package lifecycle management, artifact deployment, and service endpoint discovery.
  version: 1.0.0
  contact:
    name: SAP Support
    url: https://support.sap.com
  license:
    name: SAP Developer License
    url: https://www.sap.com/about/agreements/product-use-and-support-terms.html
  x-logo:
    url: https://www.sap.com/dam/application/shared/logos/sap-logo.svg
servers:
- url: https://{tenant-host}/api/v1
  description: SAP Integration Suite Tenant
  variables:
    tenant-host:
      default: my-tenant.integrationsuite.cfapps.sap.hana.ondemand.com
      description: SAP Integration Suite tenant host
security:
- oauth2: []
tags:
- name: Message Processing Logs
  description: Retrieve message processing logs and audit information
paths:
  /MessageProcessingLogs:
    get:
      operationId: listMessageProcessingLogs
      summary: List Message Processing Logs
      description: Retrieve message processing logs for all integration flows. Supports filtering by time range, status, and integration flow ID.
      tags:
      - Message Processing Logs
      parameters:
      - name: $filter
        in: query
        description: OData filter expression (e.g., Status eq 'FAILED')
        schema:
          type: string
      - name: $top
        in: query
        schema:
          type: integer
        description: Maximum number of log entries to return
      - name: $skip
        in: query
        schema:
          type: integer
      - name: $orderby
        in: query
        schema:
          type: string
      responses:
        '200':
          description: List of message processing logs
          content:
            application/json:
              schema:
                type: object
                properties:
                  d:
                    type: object
                    properties:
                      results:
                        type: array
                        items:
                          $ref: '#/components/schemas/MessageProcessingLog'
        '401':
          description: Unauthorized
  /MessageProcessingLogs('{MessageGuid}'):
    get:
      operationId: getMessageProcessingLog
      summary: Get Message Processing Log
      description: Retrieve a specific message processing log entry by its GUID.
      tags:
      - Message Processing Logs
      parameters:
      - name: MessageGuid
        in: path
        required: true
        description: Message processing log GUID
        schema:
          type: string
      responses:
        '200':
          description: Message processing log details
          content:
            application/json:
              schema:
                type: object
                properties:
                  d:
                    $ref: '#/components/schemas/MessageProcessingLog'
        '401':
          description: Unauthorized
        '404':
          description: Log entry not found
  /MessageProcessingLogs('{MessageGuid}')/AdapterAttributes:
    get:
      operationId: getMessageProcessingLogAdapterAttributes
      summary: Get Message Log Adapter Attributes
      description: Retrieve adapter-specific attributes for a message processing log entry.
      tags:
      - Message Processing Logs
      parameters:
      - name: MessageGuid
        in: path
        required: true
        description: Message processing log GUID
        schema:
          type: string
      responses:
        '200':
          description: Adapter attributes for the message log
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Unauthorized
components:
  schemas:
    MessageProcessingLog:
      type: object
      properties:
        MessageGuid:
          type: string
          description: Unique identifier for the message
        CorrelationId:
          type: string
          description: Correlation ID linking related messages
        ApplicationMessageId:
          type: string
          description: Application-level message ID
        ApplicationMessageType:
          type: string
          description: Application message type
        LogStart:
          type: string
          description: Message processing start time
        LogEnd:
          type: string
          description: Message processing end time
        Sender:
          type: string
          description: Sending system or adapter
        Receiver:
          type: string
          description: Receiving system or adapter
        IntegrationFlowName:
          type: string
          description: Name of the integration flow that processed the message
        Status:
          type: string
          description: Processing status
          enum:
          - COMPLETED
          - FAILED
          - PROCESSING
          - RETRY
          - ESCALATED
          - DISCARDED
          - ABANDONED
        LogLevel:
          type: string
          description: Log verbosity level
          enum:
          - INFO
          - DEBUG
          - TRACE
          - ERROR
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://{tenant}.authentication.sap.hana.ondemand.com/oauth/token
          scopes: {}