Plugins

List all Plugins

List all Plugins

get/v2/control-planes/{controlPlaneId}/core-entities/plugins

Query parameters

sizeinteger

Number of resources to be returned.

offsetstring

Offset from which to return the next set of resources. Use the value of the 'offset' field from the response of a list operation as input here to paginate through all the resources

tagsstring

A list of tags to filter the list of resources on. Multiple tags can be concatenated using ',' to mean AND or using '/' to mean OR.

filter[name][contains]string

Filter routes by a substring of the name.

filter[name][eq]string

Filter routes by their name.

Response

A successful response listing Plugins

nextstring

URI to the next page (may be null)

offsetstring

Offset is used to paginate through the API. Provide this value to the next list operation to fetch the next page

Example response

{
  "data": [
    {
      "config": {
        "anonymous": null,
        "hide_credentials": false,
        "key_in_body": false,
        "key_in_header": true,
        "key_in_query": true,
        "key_names": [
          "apikey"
        ],
        "run_on_preflight": true
      },
      "enabled": true,
      "id": "3fd1eea1-885a-4011-b986-289943ff8177",
      "name": "key-auth",
      "partials": [
        {
          "id": "cff1230a-00f7-4ae8-b376-c370f0eb4dae",
          "name": "foo-partial",
          "path": "config.redis"
        },
        {
          "id": "129ee345-cba8-4e55-9d6d-93c223ff91ae",
          "name": "bar-partial",
          "path": "config.redis"
        }
      ],
      "protocols": [
        "grpc",
        "grpcs",
        "http",
        "https"
      ]
    }
  ]
}

Changes

Changed in 5 of the 75 revisions of this API.86

    • added the optional property data/items/condition to the response with the 200 status

      response-optional-property-added

    • added the new optional query request parameter filter[name][contains]

      new-optional-request-parameter

    • added the new optional query request parameter filter[name][eq]

      new-optional-request-parameter

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 3c0154b2053a71See the full diff
    • the response property data became nullable for the status 200

      response-property-became-nullable

    • the response property data/items/ordering/after became nullable for the status 200

      response-property-became-nullable

    • the response property data/items/ordering/after/access became nullable for the status 200

      response-property-became-nullable

    • the response property data/items/ordering/before became nullable for the status 200

      response-property-became-nullable

    • the response property data/items/ordering/before/access became nullable for the status 200

      response-property-became-nullable

    • the response property data/items/partials/items/name became nullable for the status 200

      response-property-became-nullable

    • the response property data/items/partials/items/path became nullable for the status 200

      response-property-became-nullable

    • the enabled response's property default value true was added for the status 200

      response-property-default-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the enabled response's property default value true was removed for the status 200

      response-property-default-value-removed

    This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 76b0fefddb0d11See the full diff
    • the response property data/items/tags became nullable for the status 200

      response-property-became-nullable

    • the enabled response's property default value true was added for the status 200

      response-property-default-value-added