Gravitee Plugins API

Discover policies, endpoints, entrypoints, and resources installed in the gateway

GitHub OpenAPI

Operations 29

GET /plugins/endpoints List Endpoint Plugins #
GET /plugins/endpoints/{endpointId} Get an Endpoint Plugin #
GET /plugins/entrypoints List Entrypoint Plugins #
GET /plugins/policies List Policy Plugins #
GET /plugins/policies/{policyId} Get a Policy Plugin #
GET /plugins/resources List Resource Plugins #
GET /organizations/{orgId}/environments/{envId}/connectors List connector plugins #
GET /organizations/{orgId}/environments/{envId}/connectors/{connector} Get a connector #
GET /organizations/{orgId}/environments/{envId}/connectors/{connector}/documentation Get a connector's documentation #
GET /organizations/{orgId}/environments/{envId}/connectors/{connector}/schema Get a connector's schema #
GET /organizations/{orgId}/environments/{envId}/fetchers List of fetcher plugins #
GET /organizations/{orgId}/environments/{envId}/fetchers/{fetcher} Get a fetcher plugin #
GET /organizations/{orgId}/environments/{envId}/fetchers/{fetcher}/schema Get a fetcher plugin's schema #
GET /organizations/{orgId}/environments/{envId}/notifiers List notifier plugins #
GET /organizations/{orgId}/environments/{envId}/notifiers/{notifier} Get a notifier #
GET /organizations/{orgId}/environments/{envId}/notifiers/{notifier}/schema Get a notifier's schema #
GET /organizations/{orgId}/environments/{envId}/policies List policies #
GET /organizations/{orgId}/environments/{envId}/policies/swagger List policies which are handling Swagger / OAI definition #
GET /organizations/{orgId}/environments/{envId}/policies/{policy} Get a policy #
GET /organizations/{orgId}/environments/{envId}/policies/{policy}/documentation Get a policy's documentation #
GET /organizations/{orgId}/environments/{envId}/policies/{policy}/icon Get a policy's icon #
GET /organizations/{orgId}/environments/{envId}/policies/{policy}/schema Get a policy's schema #
GET /organizations/{orgId}/environments/{envId}/resources List resource plugins #
GET /organizations/{orgId}/environments/{envId}/resources/{resource} Get a resource #
GET /organizations/{orgId}/environments/{envId}/resources/{resource}/documentation Get a resource's documentation #
GET /organizations/{orgId}/environments/{envId}/resources/{resource}/schema Get a resource's schema #
GET /organizations/{orgId}/environments/{envId}/services-discovery List service discovery plugins #
GET /organizations/{orgId}/environments/{envId}/services-discovery/{plugin} Get a service discovery #
GET /organizations/{orgId}/environments/{envId}/services-discovery/{plugin}/schema Get a service discovery's schema #

Documentation

Specifications

SDKs

Other Resources

🔗
ChangeLog
https://documentation.gravitee.io/apim/release-information/changelog
🔗
License
https://github.com/gravitee-io/gravitee-api-management/blob/master/LICENSE.txt
🔗
SDKs
https://github.com/gravitee-io/gravitee-clients-sdk
🔗
SDKs
https://github.com/gravitee-io/terraform-provider-apim
🔗
CLI
https://github.com/gravitee-io/graviteeio-cli
🔗
KubernetesOperator
https://github.com/gravitee-io/gravitee-kubernetes-operator
🔗
HelmChart
https://github.com/gravitee-io/helm-charts
🔗
DockerImage
https://hub.docker.com/r/graviteeio/apim-gateway
🔗
JSONLDContext
https://artifacts.apis.io/gravitee/json-ld/gravitee-context.jsonld
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_apidefinitions.yaml
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_apiv4definitions.yaml
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_apiresources.yaml
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_applications.yaml
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_subscriptions.yaml
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_managementcontexts.yaml
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_sharedpolicygroups.yaml
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_groups.yaml
🔗
KubernetesCRD
https://artifacts.apis.io/gravitee/crd/gravitee.io_notifications.yaml
🔗
Plans
https://artifacts.apis.io/gravitee/plans/gravitee-plans-pricing.yml
🔗
FinOps
https://artifacts.apis.io/gravitee/finops/gravitee-finops.yml
🔗
Reference
https://documentation.gravitee.io/am/reference/am-api-reference
🔗
ChangeLog
https://documentation.gravitee.io/am/releases-and-changelog/release-notes
🔗
License
https://github.com/gravitee-io/gravitee-access-management/blob/master/LICENSE
🔗
SDKs
https://github.com/gravitee-io/gravitee-access-management/tree/master/gravitee-am-management-api-sdk-java
🔗
HelmChart
https://github.com/gravitee-io/helm-charts/tree/master/helm/gravitee-am
🔗
DockerImage
https://hub.docker.com/r/graviteeio/am-gateway

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/gravitee:gravitee-plugins-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gravitee-plugins-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Gravitee.io APIM Management Plugins API
  description: 'The Gravitee API Management (APIM) Management API is the administrative

    control plane for the Gravitee platform. It exposes endpoints to create

    and deploy APIs (both v2 "Gravitee definition v2" and v4 message-oriented

    APIs), manage plans, applications, subscriptions, API products,

    analytics, logs, users, plugins, UI customization, environments, and

    organization-level installation.


    This consolidated specification is synthesized from the upstream v2

    OpenAPI fragments in `gravitee-apim-rest-api-management-v2-rest`

    (`openapi-apis.yaml`, `openapi-environments.yaml`,

    `openapi-analytics.yaml`, `openapi-api-products.yaml`,

    `openapi-installation.yaml`, `openapi-plugins.yaml`,

    `openapi-users.yaml`, `openapi-logs.yaml`, `openapi-ui.yaml`).'
  contact:
    name: GraviteeSource Team
    url: https://gravitee.io
    email: team-apim@graviteesource.com
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: 2.0.0
servers:
- url: https://{host}/management/v2
  description: APIM Management API v2 - default base URL
  variables:
    host:
      default: apim.example.com
      description: Hostname of the Gravitee APIM Management API
- url: https://{host}/management/v2/organizations/{orgId}
  description: APIM Management API v2 - per-organization base URL
  variables:
    host:
      default: apim.example.com
    orgId:
      default: DEFAULT
security:
- BasicAuth: []
- CookieAuth: []
- BearerAuth: []
tags:
- name: Plugins
  description: Discover policies, endpoints, entrypoints, and resources installed in the gateway
paths:
  /plugins/endpoints:
    get:
      tags:
      - Plugins
      operationId: listEndpointPlugins
      summary: List Endpoint Plugins
      responses:
        '200':
          description: Endpoint plugins
  /plugins/endpoints/{endpointId}:
    get:
      tags:
      - Plugins
      operationId: getEndpointPlugin
      summary: Get an Endpoint Plugin
      parameters:
      - in: path
        name: endpointId
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The endpoint plugin
  /plugins/entrypoints:
    get:
      tags:
      - Plugins
      operationId: listEntrypointPlugins
      summary: List Entrypoint Plugins
      responses:
        '200':
          description: Entrypoint plugins
  /plugins/policies:
    get:
      tags:
      - Plugins
      operationId: listPolicyPlugins
      summary: List Policy Plugins
      responses:
        '200':
          description: Policy plugins
  /plugins/policies/{policyId}:
    get:
      tags:
      - Plugins
      operationId: getPolicyPlugin
      summary: Get a Policy Plugin
      parameters:
      - in: path
        name: policyId
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The policy plugin
  /plugins/resources:
    get:
      tags:
      - Plugins
      operationId: listResourcePlugins
      summary: List Resource Plugins
      responses:
        '200':
          description: Resource plugins
  /organizations/{orgId}/environments/{envId}/connectors:
    get:
      tags:
      - Plugins
      summary: List connector plugins
      description: User must have the ENVIRONMENT_API[READ] permission to use this service
      operationId: getConnectors
      parameters:
      - name: expand
        in: query
        schema:
          type: array
          items:
            type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: List of connectors
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConnectorListItem'
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/connectors/{connector}:
    get:
      tags:
      - Plugins
      summary: Get a connector
      description: User must have the ENVIRONMENT_API[READ] permission to use this service
      operationId: getConnector
      parameters:
      - name: connector
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Connector plugin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformPluginEntity'
        '404':
          description: Connector not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/connectors/{connector}/documentation:
    get:
      tags:
      - Plugins
      summary: Get a connector's documentation
      description: User must have the ENVIRONMENT_API[READ] permission to use this service
      operationId: getConnectorDoc
      parameters:
      - name: connector
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Connector documentation
          content:
            text/plain:
              schema:
                type: string
        '404':
          description: Connector not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/connectors/{connector}/schema:
    get:
      tags:
      - Plugins
      summary: Get a connector's schema
      description: User must have the ENVIRONMENT_API[READ] permission to use this service
      operationId: getConnectorSchema
      parameters:
      - name: connector
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Connector schema
          content:
            application/json:
              schema:
                type: string
        '404':
          description: Connector not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/fetchers:
    get:
      tags:
      - Plugins
      summary: List of fetcher plugins
      operationId: getFetchers
      parameters:
      - name: expand
        in: query
        explode: false
        schema:
          type: array
          items:
            type: string
      - name: import
        in: query
        schema:
          type: boolean
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: List of fetchers
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/FetcherListItem'
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/fetchers/{fetcher}:
    get:
      tags:
      - Plugins
      summary: Get a fetcher plugin
      operationId: getFetcher
      parameters:
      - name: fetcher
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Fetcher
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetcherEntity'
        '404':
          description: Fetcher not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/fetchers/{fetcher}/schema:
    get:
      tags:
      - Plugins
      summary: Get a fetcher plugin's schema
      operationId: getFetcherSchema
      parameters:
      - name: fetcher
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Fetcher's schema
          content:
            application/json:
              schema:
                type: string
        '404':
          description: Fetcher not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/notifiers:
    get:
      tags:
      - Plugins
      summary: List notifier plugins
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getNotifiers
      parameters:
      - name: expand
        in: query
        schema:
          type: array
          items:
            type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: List of notifiers
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NotifierListItem'
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/notifiers/{notifier}:
    get:
      tags:
      - Plugins
      summary: Get a notifier
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getNotifier
      parameters:
      - name: notifier
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Notifier plugin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotifierEntity'
        '404':
          description: Notifier not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/notifiers/{notifier}/schema:
    get:
      tags:
      - Plugins
      summary: Get a notifier's schema
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getNotifierSchema
      parameters:
      - name: notifier
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Notifier's schema
          content:
            application/json:
              schema:
                type: string
        '404':
          description: Notifier not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/policies:
    get:
      tags:
      - Plugins
      summary: List policies
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getPolicies
      parameters:
      - name: expand
        in: query
        schema:
          type: array
          items:
            type: string
      - name: withResource
        in: query
        schema:
          type: boolean
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        default:
          description: default response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PolicyListItem'
  /organizations/{orgId}/environments/{envId}/policies/swagger:
    get:
      tags:
      - Plugins
      summary: List policies which are handling Swagger / OAI definition
      description: These policies are used when importing an OAI to create an API
      operationId: getSwaggerPolicy
      parameters:
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        default:
          description: default response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PolicyListItem'
  /organizations/{orgId}/environments/{envId}/policies/{policy}:
    get:
      tags:
      - Plugins
      summary: Get a policy
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getPolicy
      parameters:
      - name: policy
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        default:
          description: default response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyEntity'
  /organizations/{orgId}/environments/{envId}/policies/{policy}/documentation:
    get:
      tags:
      - Plugins
      summary: Get a policy's documentation
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getPolicyDoc
      parameters:
      - name: policy
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        default:
          description: default response
          content:
            text/plain:
              schema:
                type: string
  /organizations/{orgId}/environments/{envId}/policies/{policy}/icon:
    get:
      tags:
      - Plugins
      summary: Get a policy's icon
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getPolicyIcon
      parameters:
      - name: policy
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        default:
          description: default response
          content:
            text/plain:
              schema:
                type: string
  /organizations/{orgId}/environments/{envId}/policies/{policy}/schema:
    get:
      tags:
      - Plugins
      summary: Get a policy's schema
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getPolicySchema
      parameters:
      - name: policy
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        default:
          description: default response
          content:
            application/json:
              schema:
                type: string
  /organizations/{orgId}/environments/{envId}/resources:
    get:
      tags:
      - Plugins
      summary: List resource plugins
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getResources
      parameters:
      - name: expand
        in: query
        schema:
          type: array
          items:
            type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: List of resources
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ResourceListItem'
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/resources/{resource}:
    get:
      tags:
      - Plugins
      summary: Get a resource
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getResource
      parameters:
      - name: resource
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Resource plugin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformPluginEntity'
        '404':
          description: Resource not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/resources/{resource}/documentation:
    get:
      tags:
      - Plugins
      summary: Get a resource's documentation
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getResourceDoc
      parameters:
      - name: resource
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        default:
          description: default response
          content:
            text/plain:
              schema:
                type: string
  /organizations/{orgId}/environments/{envId}/resources/{resource}/schema:
    get:
      tags:
      - Plugins
      summary: Get a resource's schema
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getResourceSchema
      parameters:
      - name: resource
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        default:
          description: default response
          content:
            application/json:
              schema:
                type: string
  /organizations/{orgId}/environments/{envId}/services-discovery:
    get:
      tags:
      - Plugins
      summary: List service discovery plugins
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getServicesDiscoverResources
      parameters:
      - name: expand
        in: query
        schema:
          type: array
          items:
            type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: List of service discovery plugins
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ResourceListItem'
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/services-discovery/{plugin}:
    get:
      tags:
      - Plugins
      summary: Get a service discovery
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getServiceDiscovery
      parameters:
      - name: plugin
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Service discovery plugin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformPluginEntity'
        '404':
          description: Resource not found
        '500':
          description: Internal server error
  /organizations/{orgId}/environments/{envId}/services-discovery/{plugin}/schema:
    get:
      tags:
      - Plugins
      summary: Get a service discovery's schema
      description: User must have the MANAGEMENT_API[READ] permission to use this service
      operationId: getServiceDiscoverySchema
      parameters:
      - name: plugin
        in: path
        required: true
        schema:
          type: string
      - name: envId
        in: path
        description: The ID of the environment
        required: true
        schema:
          type: string
          default: DEFAULT
      - name: orgId
        in: path
        description: The ID of the Organization
        required: true
        schema:
          type: string
          default: DEFAULT
      responses:
        '200':
          description: Service discovery plugin's schema
          content:
            application/json:
              schema:
                type: string
        '404':
          description: Service discovery not found
        '500':
          description: Internal server error
components:
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
    CookieAuth:
      type: apiKey
      in: cookie
      name: Auth-Graviteeio-APIM
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    gravitee-auth:
      type: http
      scheme: basic
  schemas:
    PolicyEntity:
      type: object
      properties:
        category:
          type: string
        description:
          type: string
        dev:
          $ref: '#/components/schemas/PolicyDevelopmentEntity'
        id:
          type: string
        name:
          type: string
        plugin:
          $ref: '#/components/schemas/PluginEntity'
        type:
          $ref: '#/components/schemas/PolicyType'
        version:
          type: string
    FetcherListItem:
      type: object
      properties:
        description:
          type: string
        id:
          type: string
        name:
          type: string
        schema:
          type: string
        version:
          type: string
    FetcherEntity:
      type: object
      properties:
        category:
          type: string
        description:
          type: string
        id:
          type: string
        name:
          type: string
        version:
          type: string
    PlatformPluginEntity:
      type: object
      properties:
        category:
          type: string
        description:
          type: string
        id:
          type: string
        name:
          type: string
        version:
          type: string
    ConnectorListItem:
      type: object
      properties:
        description:
          type: string
        icon:
          type: string
        id:
          type: string
        name:
          type: string
        schema:
          type: string
        supportedTypes:
          type: array
          items:
            type: string
        version:
          type: string
    PolicyListItem:
      type: object
      properties:
        category:
          type: string
        description:
          type: string
        documentation:
          type: string
        icon:
          type: string
        id:
          type: string
        name:
          type: string
        onRequest:
          type: boolean
        onResponse:
          type: boolean
        schema:
          type: string
        type:
          $ref: '#/components/schemas/PolicyType'
        version:
          type: string
    ResourceListItem:
      type: object
      properties:
        description:
          type: string
        icon:
          type: string
        id:
          type: string
        name:
          type: string
        schema:
          type: string
        version:
          type: string
    PluginEntity:
      type: object
      properties:
        dependencies:
          type: array
          items:
            type: string
            format: url
        description:
          type: string
        id:
          type: string
        name:
          type: string
        path:
          type: string
        plugin:
          type: string
        type:
          type: string
        version:
          type: string
    NotifierListItem:
      type: object
      properties:
        description:
          type: string
        id:
          type: string
        name:
          type: string
        schema:
          type: string
        version:
          type: string
    NotifierEntity:
      type: object
      properties:
        description:
          type: string
        id:
          type: string
        name:
          type: string
        plugin:
          $ref: '#/components/schemas/PluginEntity'
        version:
          type: string
    PolicyType:
      type: string
      enum:
      - REQUEST
      - RESPONSE
      - REQUEST_RESPONSE
    PolicyDevelopmentEntity:
      type: object
      properties:
        class:
          type: string
        configuration_class:
          type: string
        on_request_method:
          type: string
        on_response_method:
          type: string