# List all registered PaaS plugins.

Endpoint: GET /paas-plugins
Version: 3.30.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `limit` (integer)
    Maximum number of objects to return per query. The value must be between 1 and 1000. Default is 100.

  - `cursor` (string)
    Cursor to fetch the next or previous page of results. The value of this property must be extracted from the 'prev_cursor' or 'next_cursor' property of a PaginatedResponseMetadata which is contained in the response of list and search API endpoints.

  - `sort` (string)
    The field to sort results by. A property name with a prepended '-' signifies descending order.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    The PaaS Plugin object entity ID.
    Example: db-123

  - `items.unique_identifier` (string)
    A unique identifier for this plugin type.
    Example: my-db-123

  - `items.name` (string)
    A user friendly name describing this plugin type.
    Example: my-db-123

  - `items.schema` (string)
    The JSON schema of this plugin optional parameters and properties.
    Example: my-db-123

  - `items.version` (string)
    The version of the currently installed instance of this plugin.
    Example: my-db-123

  - `items.operation_target` (string)
    Whether this Instance's PaaS plugin operates at the instance or database level for operations such as snapshotting, provisioning and refresh.
    Enum: "PAAS_INSTANCE", "PAAS_DATABASE"

  - `items.regions` (array)
    The list of cloud regions where this plugin can operate.

  - `items.regions.value` (string, required)
    The unique identifier for the region (e.g., "us-west-2", "eastus").
    Example: us-west-2

  - `items.regions.label` (string, required)
    The human-readable label for the region (e.g., "US West Oregon", "East US").
    Example: US West Oregon

  - `items.tags` (array)

  - `items.tags.key` (string, required)
    Key of the tag
    Example: key-1

  - `items.tags.value` (string, required)
    Value of the tag
    Example: value-1

  - `response_metadata` (object)

  - `response_metadata.prev_cursor` (string)
    Pointer to the previous page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.next_cursor` (string)
    Pointer to the next page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.total` (integer)
    The total number of results. This value may not be provided.

