openapi: 3.0.3
info:
  title: Sandbox Banking Glyue Integration Gateway Adapters Run History API
  description: The Glyue Integration Gateway API provides programmatic access to the Sandbox Banking (nCino Integration Gateway) platform for building, managing, and monitoring banking integrations. The API supports creating and executing integration workflows, managing service request adapters, configuring field mappings, value mappings, validation rules, and accessing run history audit logs. Designed for financial institutions connecting core banking systems (Fiserv, Jack Henry, FIS) with fintech applications and loan origination systems.
  version: 1.0.0
  contact:
    name: Sandbox Banking Support
    url: https://glyue.docs.sandboxbanking.com/
  license:
    name: Proprietary
servers:
- url: https://{tenant}.sandboxbanking.com/api
  description: Glyue tenant API endpoint
  variables:
    tenant:
      default: your-institution
      description: Your institution's Glyue tenant subdomain
security:
- TokenAuth: []
tags:
- name: Run History
  description: Integration run audit log access.
paths:
  /run-history:
    get:
      operationId: listRunHistory
      summary: List Run History
      description: Returns the run history audit log for integration executions, with request/response bodies, timestamps, statuses, and error details.
      tags:
      - Run History
      parameters:
      - name: integration_id
        in: query
        required: false
        description: Filter by integration ID.
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: Filter by run status.
        schema:
          type: string
          enum:
          - success
          - failure
          - running
          - pending
      - name: start_date
        in: query
        required: false
        description: Filter runs on or after this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: end_date
        in: query
        required: false
        description: Filter runs on or before this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: page
        in: query
        required: false
        description: Page number.
        schema:
          type: integer
          default: 1
      - name: page_size
        in: query
        required: false
        description: Results per page.
        schema:
          type: integer
          default: 20
          maximum: 100
      responses:
        '200':
          description: Run history entries.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type: string
                    format: uri
                  previous:
                    type: string
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/RunHistoryEntry'
        '401':
          description: Unauthorized.
  /run-history/{runId}:
    get:
      operationId: getRunHistory
      summary: Get Run History Entry
      description: Returns the full audit detail for a specific integration run including request body, response body, and service request execution log.
      tags:
      - Run History
      parameters:
      - name: runId
        in: path
        required: true
        description: Run identifier.
        schema:
          type: string
      responses:
        '200':
          description: Run history detail.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunHistoryDetail'
        '401':
          description: Unauthorized.
        '404':
          description: Run not found.
components:
  schemas:
    RunHistoryDetail:
      allOf:
      - $ref: '#/components/schemas/RunHistoryEntry'
      properties:
        requestBody:
          type: object
          description: Input payload sent to the integration.
          additionalProperties: true
        responseBody:
          type: object
          description: Output payload from the integration.
          additionalProperties: true
        serviceRequestLog:
          type: array
          description: Per-service-request execution log.
          items:
            type: object
            properties:
              serviceRequestName:
                type: string
              adapter:
                type: string
              operation:
                type: string
              status:
                type: string
              requestSent:
                type: object
                additionalProperties: true
              responseReceived:
                type: object
                additionalProperties: true
              durationMs:
                type: integer
        errorDetails:
          type: string
          description: Full error traceback if run failed.
    RunHistoryEntry:
      type: object
      description: Summary of a past integration run.
      properties:
        id:
          type: string
          description: Run history entry ID.
        integrationId:
          type: string
          description: Integration identifier.
        integrationName:
          type: string
          description: Integration display name.
        status:
          type: string
          enum:
          - success
          - failure
          - running
          - pending
        startTime:
          type: string
          format: date-time
        endTime:
          type: string
          format: date-time
        durationMs:
          type: integer
          description: Run duration in milliseconds.
        triggeredBy:
          type: string
          description: User or system that triggered the run.
  securitySchemes:
    TokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Token-based authentication. Include your API token as: Authorization: Token <your-token>'