---
title: "List all non-deleted custom plugin files for the organization"
method: GET
path: "/organization/{organization_id}/kafka-connect/custom-plugin-files"
tags: ["Kafka_Connect_Custom_Plugins"]
---

# List all non-deleted custom plugin files for the organization

`GET /organization/{organization_id}/kafka-connect/custom-plugin-files`

## Path parameters

- `organization_id` string, required

## Response `200`

Response

- KafkaConnectCustomPluginFileListResponse — KafkaConnectCustomPluginFileListResponse
  - `plugin_files` object[], required — List of custom plugin files.
    - `created_at` string, required — Creation timestamp in ISO 8601 format, always in UTC.
    - `created_by` string, required — Email address of the user who created this entity.
    - `file_description` string — Optional human-readable change notes specific to this plugin version.
    - `file_sha256` string — SHA-256 hash of the uploaded file, populated after successful verification.
    - `file_size` integer — Size of the uploaded file in bytes, populated after successful verification.
    - `file_status` 'INITIAL' | 'READY' | 'FAILED', required — Verification status of the uploaded JAR. INITIAL: upload pending or in progress. READY: verified and plugin classes discovered. FAILED: verification failed.
    - `plugin_file_id` string, required — Unique identifier for this custom plugin file upload.
    - `plugin_id` string, required — Unique identifier for the plugin identity record (shared across all versions).
    - `plugin_name` string, required — User-provided name identifying this custom plugin.
    - `plugin_version` string, required — User-provided version string for this plugin upload.
    - `updated_at` string, required — Last update timestamp in ISO 8601 format, always in UTC.
    - `updated_by` string — Email address of the user who last updated this entity.
    - `verify_error_code` integer — Machine-readable error code when file_status is FAILED.
    - `verify_error_message` string — Human-readable error message when file_status is FAILED.

## Other responses

- `403` — Operation not allowed

## Changes

- **2026-09-17** `2c34e77db4df` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/aiven/apis/aiven-api-documentation/changes/organization/:organization_id/kafka-connect/custom-plugin-files/get.md)

---

[API](https://skmtc.dev/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.dev/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/aiven/apis/aiven-api-documentation/revisions/90f50802482d?raw)