> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# List External OpenAPI Schemas

> Use this endpoint to retrieve a paginated list of the tenant's external OpenAPI schemas. The response carries metadata only, without the specification content.



## OpenAPI

````yaml en/openapi/v3-current/flowker.yaml get /v1/openapi-schemas
openapi: 3.1.0
info:
  description: >-
    Complete API reference for Flowker workflow orchestration services including
    catalog management, workflow definitions, executor configurations, provider
    configurations, and workflow executions.
  title: Flowker API
  version: 1.2.0
servers:
  - url: https://flowker.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - name: Catalog API
    description: >-
      Browse built-in providers, executors, and triggers available in the
      Flowker catalog.
  - name: Workflows API
    description: >-
      Create, update, activate, deactivate, clone, and delete workflow
      definitions.
  - name: Executions API
    description: Start workflow executions and track their status and results.
  - name: Executor Configurations API
    description: >-
      List, inspect, update, and delete the executor configuration records a
      deployment holds.
  - name: Provider Configurations API
    description: >-
      Create, update, enable, and disable the provider configurations that
      workflow nodes call through.
  - name: Dashboard API
    description: >-
      Retrieve aggregated summaries of workflows and executions for operational
      dashboards.
  - name: Webhooks API
    description: >-
      Receive webhook callbacks from external systems to trigger workflow
      executions.
  - name: Schedule API
    description: >-
      Inspect a workflow's upcoming, skipped, and parked scheduled occurrences,
      and run or discard the parked ones.
  - name: Schema Registry API
    description: >-
      Publish global OpenAPI specification versions for native services and pin
      the version each tenant resolves against.
  - name: OpenAPI Schemas API
    description: >-
      Upload, inspect, and delete the tenant's external OpenAPI schemas, and
      derive the contract of a single operation.
  - name: XSD Schemas API
    description: >-
      Upload, inspect, and delete the tenant's XSD schemas used to validate XML
      webhook payloads.
paths:
  /v1/openapi-schemas:
    get:
      tags:
        - OpenAPI Schemas API
      summary: List External OpenAPI Schemas
      description: >-
        Use this endpoint to retrieve a paginated list of the tenant's external
        OpenAPI schemas. The response carries metadata only, without the
        specification content.
      operationId: listOpenAPISchemas
      parameters:
        - description: Number of items per page (1-100).
          explode: false
          in: query
          name: limit
          schema:
            default: 10
            description: Number of items per page (1-100).
            format: int64
            type: integer
            example: 10
        - description: Pagination cursor (opaque).
          explode: false
          in: query
          name: cursor
          schema:
            description: Pagination cursor (opaque).
            type: string
        - description: Sort field.
          explode: false
          in: query
          name: sortBy
          schema:
            description: Sort field.
            type: string
            example: createdAt
        - description: Sort order (ASC or DESC).
          explode: false
          in: query
          name: sortOrder
          schema:
            description: Sort order (ASC or DESC).
            type: string
            example: DESC
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAPISchemaListOutput'
          description: >-
            Indicates that the request was successful and the response contains
            the requested data.
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            Indicates that the request failed. The body is an RFC 9457 problem
            document.
components:
  schemas:
    OpenAPISchemaListOutput:
      additionalProperties: false
      properties:
        hasMore:
          type: boolean
          example: true
        items:
          items:
            $ref: '#/components/schemas/OpenAPISchemaOutput'
          type:
            - array
            - 'null'
        nextCursor:
          type: string
          example: eyJpZCI6IjAxOGYzZTJhIn0=
      required:
        - items
        - nextCursor
        - hasMore
      type: object
    ErrorResponse:
      properties:
        code:
          description: Stable, machine-readable Flowker error code.
          example: FLK-0001
          type: string
        detail:
          description: >-
            Human-readable explanation of this occurrence. Responses with a
            status of 500 or above carry a fixed generic message.
          example: name is a required field
          type: string
        errors:
          description: Per-field entries for a request that failed validation.
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
        instance:
          description: URI reference identifying this specific occurrence.
          example: /v1/workflows
          format: uri
          type: string
        status:
          description: HTTP status code.
          example: 400
          type: integer
        title:
          description: >-
            Standard HTTP reason phrase for the status. It does not change per
            error code.
          example: Bad Request
          type: string
        type:
          description: >-
            URI reference identifying the error. Always the error catalog base
            followed by the code.
          example: https://errors.lerian.studio/v1/FLK-0001
          format: uri
          type: string
      type: object
    OpenAPISchemaOutput:
      additionalProperties: false
      properties:
        byteSize:
          format: int64
          type: integer
          example: 4096
        contentHash:
          type: string
          example: >-
            sha256:9f2c8b1a4d7e0f3c6b5a8d2e1f4c7b0a3d6e9f2c5b8a1d4e7f0c3b6a9d2e5f8c
        createdAt:
          format: date-time
          type: string
          example: '2026-01-15T10:30:00Z'
        createdBy:
          type: string
          example: user@example.com
        id:
          format: uuid
          type: string
          example: 018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8
        name:
          type: string
          example: jd-spi
        openapiVersion:
          type: string
          example: 3.0.3
        operationCount:
          format: int64
          type: integer
          example: 42
        title:
          type: string
          example: JD SPI API
        version:
          type: string
          example: '1'
      required:
        - id
        - name
        - version
        - contentHash
        - byteSize
        - title
        - openapiVersion
        - operationCount
        - createdBy
        - createdAt
      type: object
    ErrorDetail:
      properties:
        location:
          description: Where the problem is, such as body.nodes or path.id.
          example: body.nodes
          type: string
        message:
          description: Description of the field-level problem.
          example: expected array length >= 1
          type: string
        value:
          description: The value that caused the error, when it is safe to echo.
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT bearer token issued by the identity provider. Send it in the
        Authorization header as `Bearer <token>`.

````