---
title: "API Version"
url: "https://nov18-dev.movespot.fyi/apis/konnect-api-catalog-dev-3/versions/b2fc1681-05e8-4b55-9b8c-8bbcc7654d1b/schemas/ApiVersion"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-api-catalog-dev-3/versions/b2fc1681-05e8-4b55-9b8c-8bbcc7654d1b.md

# API Version

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Konnect API Catalog
  version: 3.1.2
servers:
  - url: https://us.api.konghq.com/v3
    description: United-States Production region
  - url: https://eu.api.konghq.com/v3
    description: Europe Production region
  - url: https://au.api.konghq.com/v3
    description: Australia Production region
  - url: https://me.api.konghq.com/v3
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v3
    description: India Production region
  - url: https://sg.api.konghq.com/v3
    description: Singapore Production region
components:
  schemas:
    RawApiSpecProvider:
      type: object
      properties:
        type:
          type: string
          enum:
            - raw
        config:
          type: object
          additionalProperties: false
          maxProperties: 0
          minProperties: 0
      required:
        - type
        - config
    UrlApiSpecProvider:
      type: object
      properties:
        type:
          type: string
          enum:
            - url
        config:
          type: object
          properties:
            url:
              description: |
                Public URL that resolves to the raw API spec contents.
                Supported formats are JSON and YAML.
              type: string
              format: uri
              example: https://api.petstore.com/v3/openapi.json
          required:
            - url
      required:
        - type
        - config
    IntegrationApiSpecProviderPayload:
      description: >
        API spec provider registered by a catalog integration.


        Integrations can function as API spec providers where they register a
        globally unique

        `type` and config schema which defines the shape of `config`.


        Consult integration documentation to learn more about available API spec
        providers.
      type: object
      properties:
        type:
          description: The globally unique API spec provider type that is registered by a
            given catalog integration.
          type: string
          example: swaggerhub_api_version
          maxLength: 120
          minLength: 1
        config:
          description: JSON object containing values as defined by integration provider's
            config schema.
          type: object
          example:
            owner: petco
            api: pet_store
            version: v3
          additionalProperties: true
          minProperties: 1
        integration_instance:
          description: The integration instance id or name
          type: string
      required:
        - type
        - config
        - integration_instance
    ResourceBoundIntegrationApiSpecProviderPayload:
      description: >
        API spec provider registered by a catalog integration.


        These providers differ from `IntegrationApiSpecProvider` in that they

        denote a binding relationship between a resource type and the API spec.

        This means that the API Spec will automatically be created/deleted
        for/from a service

        as resources of the given type are mapped/unmapped.


        Consult integration documentation to learn more about available API spec
        providers.
      type: object
      properties:
        type:
          description: >
            The globally unique API spec provider type that is registered by a
            given catalog integration.

            Resource-bound providers create a 1-to-1 mapping between a resource
            type and the API Spec.
          type: string
          maxLength: 120
          minLength: 1
        config:
          type: object
          properties:
            resource_id:
              description: ID of the associated Resource the API spec is bound to.
              type: string
              example: IqkHvMdyHukxcwAs
          required:
            - resource_id
      required:
        - type
        - config
    CreatedAt:
      description: An ISO-8601 timestamp representation of entity creation date.
      type: string
      format: date-time
      example: 2022-11-04T20:10:06.927Z
      readOnly: true
    UpdatedAt:
      description: An ISO-8601 timestamp representation of entity update date.
      type: string
      format: date-time
      example: 2022-11-04T20:10:06.927Z
      readOnly: true
    ApiVersion:
      type: object
      properties:
        id:
          description: The API version identifier.
          type: string
          format: uuid
          example: 7710d5c4-d902-410b-992f-18b814155b53
          readOnly: true
        version:
          description: The version of the api.
          type: string
          example: 1.0.0
        spec:
          type: object
          additionalProperties: false
          properties:
            content:
              description: >
                The raw content of your API spec, in json or yaml format
                (OpenAPI or AsyncAPI).
              example: '{"openapi":"3.0.3","info":{"title":"Example
                API","version":"1.0.0"},"paths":{"/example":{"get":{"summary":"Example
                endpoint","responses":{"200":{"description":"Successful
                response"}}}}}}'
              type: string
            type:
              description: >
                The type of specification being stored. This allows us to render
                the specification correctly.
              type: string
              example: oas3
              enum:
                - oas2
                - oas3
                - asyncapi
              readOnly: true
              title: API Spec Type
            validation_messages:
              description: The errors that occurred while parsing the API version spec.
              type: array
              items:
                type: object
                additionalProperties: false
                required:
                  - message
                properties:
                  message:
                    type: string
              readOnly: true
            provider:
              description: >
                The provider used to supply the spec content. In write requests,
                provide

                this instead of or alongside content. If omitted on writes, the
                server

                infers type raw from spec.content.
              oneOf:
                - $ref: "#/components/schemas/RawApiSpecProvider"
                - $ref: "#/components/schemas/UrlApiSpecProvider"
                - $ref: "#/components/schemas/IntegrationApiSpecProviderPayload"
                - $ref: "#/components/schemas/ResourceBoundIntegrationApiSpecProviderPayload"
              title: ApiSpecProvider
        created_at:
          $ref: "#/components/schemas/CreatedAt"
        updated_at:
          $ref: "#/components/schemas/UpdatedAt"
      additionalProperties: false
      title: API Version
```
