SAP Business Intelligence Instances API

openapi: 3.1.0
info:
  title: SAP Business Intelligence SAP Analytics Cloud Catalog Instances API
  description: REST API for SAP Analytics Cloud enabling data integration, story management, model administration, and analytics operations. Provides programmatic access to create and manage stories, models, data imports, and user administration within SAP Analytics Cloud.
  version: '1.0'
  contact:
    name: SAP Support
    url: https://support.sap.com/en/index.html
  termsOfService: https://www.sap.com/about/legal/terms-of-use.html
servers:
- url: https://{tenant}.sapanalytics.cloud/api/v1
  description: SAP Analytics Cloud Tenant
  variables:
    tenant:
      default: mytenant
      description: SAP Analytics Cloud tenant identifier
security:
- oauth2: []
tags:
- name: Instances
  description: Manage scheduled report instances
paths:
  /infostore/{objectId}/schedules:
    get:
      operationId: listSchedules
      summary: SAP Business Intelligence List schedules for an object
      description: Retrieve all schedules configured for a specific InfoObject.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/objectId'
      responses:
        '200':
          description: List of schedules
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduleCollection'
        '401':
          description: Unauthorized
        '404':
          description: InfoObject not found
    post:
      operationId: scheduleObject
      summary: SAP Business Intelligence Schedule an object
      description: Create a new schedule for a report or program object.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/objectId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateScheduleRequest'
      responses:
        '201':
          description: Schedule created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Schedule'
        '400':
          description: Invalid request
        '401':
          description: Unauthorized
        '404':
          description: InfoObject not found
  /infostore/{objectId}/instances:
    get:
      operationId: listInstances
      summary: SAP Business Intelligence List instances of an object
      description: Retrieve all report instances generated from scheduling or on-demand execution.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/objectId'
      - $ref: '#/components/parameters/limitParam'
      - $ref: '#/components/parameters/offsetParam'
      responses:
        '200':
          description: List of instances
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InstanceCollection'
        '401':
          description: Unauthorized
        '404':
          description: InfoObject not found
components:
  parameters:
    limitParam:
      name: limit
      in: query
      description: Maximum number of results to return
      schema:
        type: integer
        default: 50
        minimum: 1
        maximum: 1000
    objectId:
      name: objectId
      in: path
      required: true
      description: InfoObject unique identifier (CUID or SI_ID)
      schema:
        type: string
    offsetParam:
      name: offset
      in: query
      description: Number of results to skip for pagination
      schema:
        type: integer
        default: 0
        minimum: 0
  schemas:
    CreateScheduleRequest:
      type: object
      required:
      - name
      - recurrenceType
      properties:
        name:
          type: string
          description: Schedule name
        recurrenceType:
          type: string
          enum:
          - Once
          - Daily
          - Weekly
          - Monthly
          description: Recurrence pattern
        startTime:
          type: string
          format: date-time
          description: When the schedule starts
        endTime:
          type: string
          format: date-time
          description: When the schedule ends
        format:
          type: string
          enum:
          - PDF
          - Excel
          - CSV
          - HTML
          description: Output format
    Schedule:
      type: object
      properties:
        id:
          type: string
          description: Schedule unique identifier
        name:
          type: string
          description: Schedule name
        status:
          type: string
          enum:
          - Active
          - Paused
          - Completed
          description: Schedule status
        recurrenceType:
          type: string
          enum:
          - Once
          - Daily
          - Weekly
          - Monthly
          description: Recurrence pattern
        nextRunTime:
          type: string
          format: date-time
          description: Next scheduled run time
        format:
          type: string
          enum:
          - PDF
          - Excel
          - CSV
          - HTML
          description: Output format
    ScheduleCollection:
      type: object
      properties:
        schedules:
          type: array
          items:
            $ref: '#/components/schemas/Schedule'
    Instance:
      type: object
      properties:
        id:
          type: integer
          description: Instance unique identifier
        name:
          type: string
          description: Instance title
        status:
          type: string
          enum:
          - Pending
          - Running
          - Success
          - Failed
          - Paused
          description: Execution status
        startTime:
          type: string
          format: date-time
          description: When the instance began running
        endTime:
          type: string
          format: date-time
          description: When the instance completed
        format:
          type: string
          description: Output format
    InstanceCollection:
      type: object
      properties:
        instances:
          type: array
          items:
            $ref: '#/components/schemas/Instance'
        totalCount:
          type: integer
          description: Total number of instances
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.0 authentication for SAP Analytics Cloud
      flows:
        clientCredentials:
          tokenUrl: https://{tenant}.sapanalytics.cloud/oauth/token
          scopes: {}
externalDocs:
  description: SAP Analytics Cloud API Documentation
  url: https://help.sap.com/docs/SAP_ANALYTICS_CLOUD