> ## Documentation Index > Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Custom Integrations > List all custom integrations for the organization. **Filtering Options:** - `integration_type`: Filter by type (postgres, mongodb, redis, etc.) - `status`: Filter by status (active, inactive, deleted) - `tags`: Filter by tags (comma-separated, e.g., "production,database") **Default Behavior:** - Excludes deleted integrations unless explicitly filtered - Results sorted by creation date (newest first) **Example:** ``` GET /api/v1/custom-integrations?integration_type=postgres&tags=production ``` ## OpenAPI ````yaml https://control-plane.kubiya.ai/api/openapi.json get /api/v1/custom-integrations openapi: 3.1.0 info: title: Agent Control Plane API description: Multi-tenant agent orchestration with Temporal workflows version: 1.0.0 servers: [] security: - BearerAuth: [] tags: - name: health description: πŸ₯ **Health & Status** - Check API health and availability - name: authentication description: πŸ” **Authentication** - Token validation and auth management - name: agents description: πŸ€– **Agents** - Create and manage AI agents with custom capabilities - name: skills description: πŸ› οΈ **Tool Sets** - Manage agent skills and tool configurations - name: integrations description: πŸ”Œ **Integrations** - Connect to external services (Kubiya managed) - name: custom-integrations description: >- βš™οΈ **Custom Integrations** - User-defined integration instances with env vars, secrets, and files - name: integration-templates description: >- πŸ“¦ **Integration Templates** - Pre-configured templates for common services (PostgreSQL, Redis, MongoDB, etc.) - name: secrets description: πŸ”‘ **Secrets** - Secure credential storage and retrieval - name: teams description: πŸ‘₯ **Teams** - Team management and collaboration - name: workflows description: πŸ“Š **Workflows** - Multi-step automation and orchestration - name: executions description: ▢️ **Executions** - Track and monitor workflow runs - name: jobs description: ⏰ **Jobs** - Scheduled and webhook-triggered tasks - name: policies description: πŸ›‘οΈ **Policies** - Access control and security policies - name: analytics description: πŸ“ˆ **Analytics** - Usage metrics and performance monitoring - name: projects description: πŸ“ **Projects** - Project organization and management - name: environments description: 🌍 **Environments** - Environment configuration (dev, staging, prod) - name: models description: 🧠 **Models** - LLM model configuration and management - name: runtimes description: ⚑ **Runtimes** - Agent execution runtime environments - name: workers description: πŸ‘· **Workers** - Worker registration and heartbeat monitoring - name: storage description: πŸ’Ύ **Storage** - File storage and cloud integration - name: context-graph description: πŸ•ΈοΈ **Context Graph** - Knowledge graph and context management - name: temporal-workflows description: >- βš™οΈ **Temporal Workflows** - Background workflows for context graph ingestion, connector operations, and scheduled jobs - name: templates description: πŸ“ **Templates** - Reusable configuration templates paths: /api/v1/custom-integrations: get: tags: - custom-integrations summary: List Custom Integrations description: |- List all custom integrations for the organization. **Filtering Options:** - `integration_type`: Filter by type (postgres, mongodb, redis, etc.) - `status`: Filter by status (active, inactive, deleted) - `tags`: Filter by tags (comma-separated, e.g., "production,database") **Default Behavior:** - Excludes deleted integrations unless explicitly filtered - Results sorted by creation date (newest first) **Example:** ``` GET /api/v1/custom-integrations?integration_type=postgres&tags=production ``` operationId: list_custom_integrations_api_v1_custom_integrations_get parameters: - name: integration_type in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by integration type (e.g., postgres, mongodb, redis) title: Integration Type description: Filter by integration type (e.g., postgres, mongodb, redis) - name: status in: query required: false schema: anyOf: - $ref: '#/components/schemas/CustomIntegrationStatus' - type: 'null' description: Filter by status (active, inactive, deleted) title: Status description: Filter by status (active, inactive, deleted) - name: tags in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by tags - comma-separated (e.g., production,database) title: Tags description: Filter by tags - comma-separated (e.g., production,database) responses: '200': description: List of custom integrations content: application/json: schema: type: array items: $ref: '#/components/schemas/CustomIntegrationResponse' title: >- Response List Custom Integrations Api V1 Custom Integrations Get example: - id: 550e8400-e29b-41d4-a716-446655440000 organization_id: org-123 name: production-postgres integration_type: postgres description: Production PostgreSQL database status: active config: env_vars: DB_HOST: postgres.example.com secrets: - DB_PASSWORD tags: - production - database created_at: '2025-12-16T10:00:00Z' updated_at: '2025-12-16T10:00:00Z' created_by: user-123 '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: CustomIntegrationStatus: type: string enum: - active - inactive - deleted title: CustomIntegrationStatus description: Custom integration status CustomIntegrationResponse: properties: id: type: string title: Id organization_id: type: string title: Organization Id name: type: string title: Name integration_type: type: string title: Integration Type description: anyOf: - type: string - type: 'null' title: Description status: type: string title: Status config: additionalProperties: true type: object title: Config tags: items: type: string type: array title: Tags created_at: type: string title: Created At updated_at: type: string title: Updated At created_by: anyOf: - type: string - type: 'null' title: Created By type: object required: - id - organization_id - name - integration_type - description - status - config - tags - created_at - updated_at - created_by title: CustomIntegrationResponse description: Custom integration response HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Enter your Kubiya API token (format: Bearer )' ````