Axway provider API

The provider API from Axway — 13 operation(s) for provider.

OpenAPI Specification

axway-provider-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  version: 16.10.0
  title: Amplify Platform API v1.0.0 aca provider API
  description: 'The Amplify Platform API provides the interface to perform the following:

    - Manage account settings and credentials

    - Manage organization settings, users, service accounts, and teams

    - Retrieve organization usage data

    - Register and manage applications

    - Retrieve application metrics and analytics

    - Retrieve user, organization, and application activity


    See the <a href="https://docs.axway.com/bundle/amplify-central/page/docs/integrate_with_central/platform-auth-examples/index.html" target="_blank">Amplify Guide</a> for documentation and examples on how to authorize API calls to platform services.


    For general documentation refer to the <a href="https://docs.axway.com/category/platform" target="_blank">Amplify Platform documentation</a>.


    &copy; Axway 2026. All rights reserved.'
  contact:
    email: support@axway.com
  termsOfService: https://www.axway.com/en/axway-platform-terms-of-use
servers:
- url: https://platform.axway.com/api/v1
tags:
- name: provider
paths:
  /provider:
    parameters: []
    post:
      summary: Axway Create Provider Marketplace
      description: "Creates a provider marketplace.\n\n___Auth Requirement___\n - _All of_\n     - `administrator` access to the organization.\n     - The organization entitlements allow `Hub.Marketplaces`.\n"
      externalDocs:
        description: Managing Marketplaces
        url: https://docs.axway.com/bundle/amplify-central/page/docs/manage_marketplace/customize_marketplace/index.html
      tags:
      - provider
      operationId: provider_create
      x-publishes:
      - marketplace.create
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Response'
                - properties:
                    result:
                      type: object
                      required:
                      - consumer
                      - consumer_approve
                      - guid
                      - name
                      - org_guid
                      - public
                      - signup
                      - terms
                      x-defs:
                        menu_item:
                          type: object
                          required:
                          - type
                          - text
                          - url
                          unevaluatedProperties: false
                          discriminator:
                            propertyName: type
                            mapping:
                              url: '#/components/schemas/Provider/x-defs/menu_item/oneOf/0'
                              document: '#/components/schemas/Provider/x-defs/menu_item/oneOf/1'
                          oneOf:
                          - type: object
                            properties:
                              type:
                                type: string
                                enum:
                                - url
                              url:
                                type: string
                                description: URL or relative path for the link.
                                pattern: (^((https?:\/\/[A-Za-z0-9.-]+|(?:www\.|[-;:&=+$,\w]+@)[A-Za-z0-9.-]+)((?:\/[+~%/.\w\-_]*)?\??(?:[-+=&;%@.\w_]*)#?(?:[\w?/:@\-._~!$&'()*+,;=]*))?)$|^(?:\/[+~%/.\w\-_]*)(?:\?[-+=&;%@.\w_]*)?(?:#[.!/\\\w]*)?$)
                          - type: object
                            properties:
                              type:
                                type: string
                                enum:
                                - document
                              url:
                                type: string
                                description: Document resource guid
                          properties:
                            new_tab:
                              type: boolean
                              description: Whether the link opens in a new tab.
                            text:
                              type: string
                              description: Label for the link.
                              x-no-tags: true
                            type:
                              type: string
                              description: Type of the link.
                              enum:
                              - document
                              - url
                            url:
                              type: string
                              description: URL, relative path, or document resource guid for the link.
                            visibility:
                              type: integer
                              description: 'Which users the link is visible to. Always shown: 0, Signed in: 1, Signed out: 2, Hidden: 3'
                              enum:
                              - 0
                              - 1
                              - 2
                              - 3
                        onboarding.items.hint:
                          type: string
                          description: Contextual information for the element.
                        onboarding.items.text:
                          type: string
                          description: Label for the element.
                        onboarding_props:
                          type: object
                          required:
                          - id
                          - type
                          - text
                          properties:
                            hint:
                              type: object
                              description: Contextual information for the element.
                              default: {}
                              properties:
                                en-US:
                                  type: string
                                  description: English language value.
                                  allOf:
                                  - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.hint'
                                fr-FR:
                                  type: string
                                  description: French language value.
                                  allOf:
                                  - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.hint'
                                de-DE:
                                  type: string
                                  description: German language value.
                                  allOf:
                                  - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.hint'
                                pt-BR:
                                  type: string
                                  description: Portuguese language value.
                                  allOf:
                                  - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.hint'
                            id:
                              type: string
                              description: Identifier for the element.
                              pattern: '[\w-]{21}'
                            required:
                              type: boolean
                              description: Whether entry is required for the element.
                            text:
                              type: object
                              description: Label for the element.
                              default: {}
                              properties:
                                en-US:
                                  type: string
                                  description: English language value.
                                  allOf:
                                  - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.text'
                                fr-FR:
                                  type: string
                                  description: French language value.
                                  allOf:
                                  - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.text'
                                de-DE:
                                  type: string
                                  description: German language value.
                                  allOf:
                                  - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.text'
                                pt-BR:
                                  type: string
                                  description: Portuguese language value.
                                  allOf:
                                  - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.text'
                            type:
                              type: string
                              description: Type of element.
                              enum:
                              - header
                              - text
                              - number
                              - date
                              - checkbox
                              - toggle
                              - select
                              - multiselect
                            visibility:
                              type: number
                              description: Whether the field is only available to provider administrators
                              enum:
                              - 0
                              - 1
                        onboarding.items.placeholder:
                          type: string
                          description: Placeholder or example value for the element.
                        placeholder:
                          type: object
                          description: Placeholder or example value for the element.
                          default: {}
                          properties:
                            en-US:
                              type: string
                              description: English language value.
                              allOf:
                              - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.placeholder'
                            fr-FR:
                              type: string
                              description: French language value.
                              allOf:
                              - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.placeholder'
                            de-DE:
                              type: string
                              description: German language value.
                              allOf:
                              - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.placeholder'
                            pt-BR:
                              type: string
                              description: Portuguese language value.
                              allOf:
                              - $ref: '#/components/schemas/Provider/x-defs/onboarding.items.placeholder'
                        homepage_border:
                          type: object
                          description: Item border properties.
                          properties:
                            color:
                              type: string
                              format: color
                              description: Border color
                            radius:
                              type: string
                              description: Border radius
                              default: square
                              enum:
                              - square
                              - rounded
                              - pill
                            style:
                              type: string
                              description: Border style
                              default: solid
                              enum:
                              - solid
                              - dashed
                              - dotted
                            width:
                              type: object
                              additionalProperties: false
                              properties:
                                bottom:
                                  type: string
                                  pattern: ^[0-9]+\.?([0-9]+)?px$
                                left:
                                  type: string
                                  pattern: ^[0-9]+\.?([0-9]+)?px$
                                right:
                                  type: string
                                  pattern: ^[0-9]+\.?([0-9]+)?px$
                                top:
                                  type: string
                                  pattern: ^[0-9]+\.?([0-9]+)?px$
                        homepage_spacing:
                          type: object
                          additionalProperties: false
                          properties:
                            bottom:
                              type: string
                              pattern: ^[0-9]+\.?([0-9]+)?(px|%|em|rem)$
                            left:
                              type: string
                              pattern: ^[0-9]+\.?([0-9]+)?(px|%|em|rem)$
                            right:
                              type: string
                              pattern: ^[0-9]+\.?([0-9]+)?(px|%|em|rem)$
                            top:
                              type: string
                              pattern: ^[0-9]+\.?([0-9]+)?(px|%|em|rem)$
                        genderedLangSchema:
                          type: object
                          properties:
                            en-US:
                              type: 'null'
                              description: English language value.
                              enum:
                              - null
                            fr-FR:
                              type: string
                              description: French language value.
                              enum:
                              - m
                              - f
                            de-DE:
                              type: string
                              description: German language value.
                              enum:
                              - m
                              - f
                              - n
                            pt-BR:
                              type: string
                              description: Portuguese language value.
                              enum:
                              - m
                              - f
                        description:
                          type: string
                          description: Description of the provider marketplace instance.
                          default: ''
                          maxLength: 200
                        footer.items:
                          type: array
                          description: Elements shown in the footer block.
                          maxItems: 10
                          items:
                            type: object
                            unevaluatedProperties: false
                            discriminator:
                              propertyName: type
                              mapping:
                                nav_menu: '#/components/schemas/Provider/x-defs/footer.items/items/oneOf/0'
                                logo: '#/components/schemas/Provider/x-defs/footer.items/items/oneOf/1'
                                text: '#/components/schemas/Provider/x-defs/footer.items/items/oneOf/2'
                                separator: '#/components/schemas/Provider/x-defs/footer.items/items/oneOf/3'
                            oneOf:
                            - title: Menu
                              description: Navigation menu.
                              required:
                              - items
                              properties:
                                items:
                                  type: array
                                  title: Navigation Menu Items
                                  description: Links added in the footer navigation menu.
                                  maxItems: 9
                                  items:
                                    $ref: '#/components/schemas/Provider/x-defs/menu_item'
                                type:
                                  enum:
                                  - nav_menu
                            - title: Logo
                              description: Company logo.
                              required:
                              - image
                              properties:
                                image:
                                  type: string
                                  description: Company logo.
                                tagline:
                                  type: string
                                  format: html
                                  description: Company tagline.
                                type:
                                  enum:
                                  - logo
                            - title: Text
                              description: Text block.
                              required:
                              - content
                              properties:
                                content:
                                  type: string
                                  format: html
                                  description: Text block to show in the footer.
                                type:
                                  enum:
                                  - text
                            - title: Separator
                              description: Separator.
                              properties:
                                type:
                                  enum:
                                  - separator
                            properties:
                              position:
                                type: string
                                description: Alignment of the content within the footer block.
                                enum:
                                - left
                                - center
                                - right
                              type:
                                type: string
                                description: Content type
                        help_menu:
                          type: array
                          description: Content shown in the navigation bar help menu.
                          items:
                            type: object
                            unevaluatedProperties: false
                            allOf:
                            - $ref: '#/components/schemas/Provider/x-defs/menu_item'
                            properties:
                              icon:
                                type: string
                                description: Icon displayed in the menu for the item.
                        homepage_categories_title:
                          type: string
                          description: Title for the categories.
                        homepage_content_button_text:
                          type: string
                          description: Button text
                        homepage_content_image_alt:
                          type: string
                          description: Image alt text.
                        homepage_content_search_text:
                          type: string
                          description: Placeholder text
                        homepage_content_text:
                          type: string
                          description: Text content, using markdown formatting.
                        homepage_products_title:
                          type: string
                          description: Title for the products.
                        name:
                          type: string
                          description: Name of the provider marketplace instance.
                          minLength: 2
                          maxLength: 350
                          x-no-tags: true
                        nav_items:
                          type: array
                          description: Links added in the common navigation menu.
                          maxItems: 9
                          items:
                            $ref: '#/components/schemas/Provider/x-defs/menu_item'
                        onboarding.items.off:
                          type: string
                          description: Label for disabled toggle state.
                        onboarding.items.on:
                          type: string
                          description: Label for enabled toggle state.
                        onboarding.items.options.text:
                          type: string
                          description: Label for value.
                        reviews.instructions:
                          type: string
                          description: Review guidelines and policies within the provider marketplace.
                          x-no-tags: true
                        sitename:
                          type: string
                          description: Page title of the provider marketplace instance.
                          maxLength: 350
                          x-no-tags: true
                      unevaluatedProperties: false
                      allOf:
                      - $ref: '#/components/schemas/DefaultFields'
                      properties:
                        _id:
                          type: string
                          description: Document ID of the provider.
                          readOnly: true
                          deprecated: true
                        admin_teams:
                          description: Administration access.
                          default: false
                          oneOf:
                          - type: boolean
                            description: Flag indicating if `marketplace_admin` role members in all teams can administer the provider marketplace.
                          - type: array
                            description: '`guid` of a selected team whose `marketplace_admin` role members can administer the provider marketplace.'
                            items:
                              type: string
                              format: uuid
                        consume_teams:
                          type: object
                          description: Preference for which org members can consume the provider marketplace.
                          default:
                            type: teams
                            value: true
                          unevaluatedProperties: false
                          discriminator:
                            propertyName: type
                            mapping:
                              teams: '#/components/schemas/Provider/properties/consume_teams/oneOf/0'
                              included: '#/components/schemas/Provider/properties/consume_teams/oneOf/1'
                              excluded: '#/components/schemas/Provider/properties/consume_teams/oneOf/1'
                              tags: '#/components/schemas/Provider/properties/consume_teams/oneOf/2'
                          oneOf:
                          - type: object
                            title: All Teams
                            properties:
                              type:
                                enum:
                                - teams
                              value:
                                type: boolean
                                description: Indicates if `consumer` role members in all teams can consume the provider marketplace.
                          - type: object
                            title: Specific Teams
                            properties:
                              type:
                                enum:
                                - included
                                - excluded
                              value:
                                type: array
                                description: '`guid` of a selected teams whose `consumer` role members can consume the provider marketplace.'
                                items:
                                  type: string
                                  format: uuid
                          - type: object
                            title: Tagged Teams
                            properties:
                              type:
                                enum:
                                - tags
                              value:
                                type: array
                                description: '`consumer` role members in teams with any value in its `tags` can consume the provider marketplace.'
                                items:
                                  type: string
                          properties:
                            type:
                              type: string
                              description: Setting for how to apply consumption preference value.
                        publish_teams:
                          type: object
                          description: Preference for which org members can publish products to the provider marketplace.
                          default:
                            type: teams
                            value: true
                          unevaluatedProperties: false
                          discriminator:
                            propertyName: type
                            mapping:
                              teams: '#/components/schemas/Provider/properties/publish_teams/oneOf/0'
                              included: '#/components/schemas/Provider/properties/publish_teams/oneOf/1'
                              excluded: '#/components/schemas/Provider/properties/publish_teams/oneOf/1'
                              tags: '#/components/schemas/Provider/properties/publish_teams/oneOf/2'
                          oneOf:
                          - type: object
                            title: All Teams
                            properties:
                              type:
                                enum:
                                - teams
                              value:
                                type: boolean
                                description: Indicates if `catalog_manager` role members in all teams can publish to the provider marketplace.
                          - type: object
                            title: Specific Teams
                            properties:
                              type:
                                enum:
                                - included
                                - excluded
                              value:
                                type: array
                                description: '`guid` of a selected teams whose `catalog_manager` role members can publish to the provider marketplace.'
                                items:
                                  type: string
                                  format: uuid
                          - type: object
                            title: Tagged Teams
                            properties:
                              type:
                                enum:
                                - tags
                              value:
                                type: array
                                description: '`catalog_manager` role members in teams with any value in its `tags` can publish to the provider marketplace.'
                                items:
                                  type: string
                          properties:
                            type:
                              type: string
                              description: Setting for how to apply publication preference value.
                        ai:
                          type: object
                          default:
                            enabled: false
                          properties:
                            enabled:
                              type: boolean
                              description: Whether AI integration is enabled for the provider marketplace.
                              default: false
                            embedded:
                              type: boolean
                              description: Whether AI integration uses built-in LLM (or customer hosted).
                              default: false
                            key_set:
                              type: string
                              format: date-time
                              description: Date and time when API key was last set.
                              readOnly: true
                            stream:
                              type: boolean
                              description: Whether LLM supports SSE events stream.
                              default: true
                            url:
                              type: string
                              format: secure-url
                              description: URL of customer hosted LLM.
                        appearance:
                          type: object
                          description: Appearance settings for the provider marketplace.
                          additionalProperties: false
                          properties:
                            favicon:
                              type: string
                              description: URL of the provider marketplace favicon.
                            logo:
                              type: string
                              description: URL of the provider marketplace logo.
                            theme_bg:
                              type: string
                              format: color
                              description: Color for page background.
                            theme_black:
                              type: string
                              format: color
                              description: Color for default elements.
                            theme_link:
                              type: string
                              format: color
                              description: Color for text links.
                            theme_primary:
                              type: string
                              format: color
                              description: Color for action controls.
                            theme_primary_alt:
                              type: string
                              format: color
                              description: Supplementary content color for primary action controls.
                            theme_secondary:
                              type: string
                              format: color
                              description: Color for secondary elements.
                            theme_secondary_alt:
                              type: string
                              format: color
                              description: Supplementary content color for secondary action controls.
                            theme_tertiary:
                              type: string
                              format: color
                              description: Color for tertiary elements.
                            theme_tertiary_alt:
                              type: string
                              format: color
                              description: Supplementary content color for tertiary action controls.
                            theme_danger:
                              type: string
                              format: color
                              description: Color for danger elements.
    

# --- truncated at 32 KB (641 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/axway/refs/heads/main/openapi/axway-provider-api-openapi.yml