# wso2/carbon-apimgt architecture

> Architecture diagram of the GitHub repository wso2/carbon-apimgt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wso2/carbon-apimgt
- Repository: https://github.com/wso2/carbon-apimgt

## Overview

carbon-apimgt is WSO2’s API-management platform. The sampled implementation supports a clear AI-provider lifecycle: administrators manage provider records, built-in connector services describe providers and their metadata, and the gateway has provider-management components. A separate governance capability validates API specifications against rulesets. The tree documents broader API publishing, subscription, gateway, and key-manager surfaces, but the excerpts do not establish their runtime call paths; those links are therefore omitted or marked unverified. Some major indexed modules are absent from the supplied tree, so they are not assigned invented paths.

Main entry points: [`components/apimgt/org.wso2.carbon.apimgt.impl/src/main/java/org/wso2/carbon/apimgt/impl/LLMProviderRegistrationService.java`](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.impl/src/main/java/org/wso2/carbon/apimgt/impl/LLMProviderRegistrationService.java) (Provider registration), [`components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/VertexAIAnthropicLLMProviderService.java`](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/VertexAIAnthropicLLMProviderService.java) (Vertex Anthropic connector), [`components/governance/org.wso2.carbon.apimgt.governance.engine/src/main/java/org/wso2/carbon/apimgt/governance/engine/SpectralValidationEngine.java`](https://github.com/wso2/carbon-apimgt/blob/master/components/governance/org.wso2.carbon.apimgt.governance.engine/src/main/java/org/wso2/carbon/apimgt/governance/engine/SpectralValidationEngine.java) (Spectral engine), [`components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/ValidationEngine.java`](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/ValidationEngine.java) (Validation contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provider_lifecycle["AI provider lifecycle"]
  node_admin_api["Provider admin API"]
  node_publisher_api["Provider publisher API"]
  node_internal_api["Internal provider API"]
  node_provider_registration["Provider registration"]
  node_provider_admin_contract["Provider admin contract<br/>[APIAdmin.java]"]
  node_provider_service["Provider service contract"]
  node_builtin_connector["Built-in connectors"]
  node_vertex_connector["Vertex Anthropic connector"]
  node_provider_model["Provider model<br/>[LLMProvider.java]"]
  node_provider_configuration["Provider configuration"]
  node_provider_metadata["Provider metadata"]
  node_gateway_provider_manager["Gateway provider manager"]
end

subgraph group_api_management["API management"]
  node_api_product["API products<br/>[APIProduct.java]"]
  node_key_validation["Key validation"]
  node_gateway_api["Gateway API routes"]
end

subgraph group_governance["API governance"]
  node_rules_api["Governance rules API"]
  node_governance_service["Governance service"]
  node_validation_service["Validation service"]
  node_validation_contract["Validation contract"]
  node_spectral_engine["Spectral engine"]
  node_compliance_manager["Compliance manager"]
end

node_administrator(("Administrator"))
node_publisher(("API publisher"))
node_llm_service{{"LLM provider"}}

node_administrator -.->|"manages providers"| node_admin_api
node_publisher -.->|"manages providers"| node_publisher_api
node_provider_registration -->|"uses admin contract"| node_provider_admin_contract
node_provider_registration -->|"registers services"| node_provider_service
node_provider_registration -->|"gets built-in provider"| node_builtin_connector
node_vertex_connector -->|"builds provider"| node_provider_model
node_vertex_connector -->|"sets configuration"| node_provider_configuration
node_vertex_connector -->|"sets metadata"| node_provider_metadata
node_gateway_provider_manager -.->|"dispatches requests"| node_llm_service
node_rules_api -.->|"routes rules"| node_governance_service
node_validation_service -->|"implements contract"| node_validation_contract
node_spectral_engine -->|"implements contract"| node_validation_contract
node_compliance_manager -.->|"uses validator"| node_spectral_engine

click node_admin_api "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.rest.api.admin.v1/src/main/java/org/wso2/carbon/apimgt/rest/api/admin/v1/impl/LlmProvidersApiServiceImpl.java"
click node_publisher_api "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.rest.api.publisher.v1/src/main/java/org/wso2/carbon/apimgt/rest/api/publisher/v1/impl/LlmProvidersApiServiceImpl.java"
click node_internal_api "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.internal.service/src/gen/java/org/wso2/carbon/apimgt/internal/service/LlmProvidersApiService.java"
click node_provider_registration "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.impl/src/main/java/org/wso2/carbon/apimgt/impl/LLMProviderRegistrationService.java"
click node_provider_admin_contract "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/APIAdmin.java"
click node_provider_service "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderService.java"
click node_builtin_connector "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/BuiltInLLMProviderService.java"
click node_vertex_connector "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/VertexAIAnthropicLLMProviderService.java"
click node_provider_model "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/LLMProvider.java"
click node_provider_configuration "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderConfiguration.java"
click node_provider_metadata "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderMetadata.java"
click node_gateway_provider_manager "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.gateway/src/main/java/org/wso2/carbon/apimgt/gateway/LLMProviderManager.java"
click node_api_product "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/APIProduct.java"
click node_key_validation "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.keymgt/src/main/java/org/wso2/carbon/apimgt/keymgt/service/APIKeyValidationService.java"
click node_gateway_api "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.rest.api.gateway/src/gen/java/org/wso2/carbon/apimgt/rest/api/gateway/ApisApiService.java"
click node_rules_api "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.rest.api/src/gen/java/org/wso2/carbon/apimgt/governance/rest/api/RulesetsApiService.java"
click node_governance_service "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/service/APIMGovernanceService.java"
click node_validation_service "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.impl/src/main/java/org/wso2/carbon/apimgt/governance/impl/validator/ValidationEngineService.java"
click node_validation_contract "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/ValidationEngine.java"
click node_spectral_engine "https://github.com/wso2/carbon-apimgt/blob/master/components/governance/org.wso2.carbon.apimgt.governance.engine/src/main/java/org/wso2/carbon/apimgt/governance/engine/SpectralValidationEngine.java"
click node_compliance_manager "https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.impl/src/main/java/org/wso2/carbon/apimgt/governance/impl/ComplianceManager.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_admin_api,node_publisher_api,node_internal_api,node_provider_registration,node_provider_admin_contract,node_provider_service,node_builtin_connector,node_vertex_connector,node_provider_model,node_provider_configuration,node_provider_metadata,node_gateway_provider_manager toneBlue
class node_api_product,node_key_validation,node_gateway_api toneAmber
class node_rules_api,node_governance_service,node_validation_service,node_validation_contract,node_spectral_engine,node_compliance_manager,node_publisher toneMint
class node_administrator,node_llm_service toneIndigo
```

## Components

### AI provider lifecycle

- [Provider admin API](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.rest.api.admin.v1/src/main/java/org/wso2/carbon/apimgt/rest/api/admin/v1/impl/LlmProvidersApiServiceImpl.java): `components/apimgt/org.wso2.carbon.apimgt.rest.api.admin.v1/src/main/java/org/wso2/carbon/apimgt/rest/api/admin/v1/impl/LlmProvidersApiServiceImpl.java`
- [Provider publisher API](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.rest.api.publisher.v1/src/main/java/org/wso2/carbon/apimgt/rest/api/publisher/v1/impl/LlmProvidersApiServiceImpl.java): `components/apimgt/org.wso2.carbon.apimgt.rest.api.publisher.v1/src/main/java/org/wso2/carbon/apimgt/rest/api/publisher/v1/impl/LlmProvidersApiServiceImpl.java`
- [Internal provider API](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.internal.service/src/gen/java/org/wso2/carbon/apimgt/internal/service/LlmProvidersApiService.java): `components/apimgt/org.wso2.carbon.apimgt.internal.service/src/gen/java/org/wso2/carbon/apimgt/internal/service/LlmProvidersApiService.java`
- [Provider registration](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.impl/src/main/java/org/wso2/carbon/apimgt/impl/LLMProviderRegistrationService.java): `components/apimgt/org.wso2.carbon.apimgt.impl/src/main/java/org/wso2/carbon/apimgt/impl/LLMProviderRegistrationService.java`
- [Provider admin contract](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/APIAdmin.java): `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/APIAdmin.java`
- [Provider service contract](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderService.java): `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderService.java`
- [Built-in connectors](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/BuiltInLLMProviderService.java): `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/BuiltInLLMProviderService.java`
- [Vertex Anthropic connector](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/VertexAIAnthropicLLMProviderService.java): `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/VertexAIAnthropicLLMProviderService.java`
- [Provider model](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/LLMProvider.java): `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/LLMProvider.java`
- [Provider configuration](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderConfiguration.java): `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderConfiguration.java`
- [Provider metadata](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderMetadata.java): `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/LLMProviderMetadata.java`
- [Gateway provider manager](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.gateway/src/main/java/org/wso2/carbon/apimgt/gateway/LLMProviderManager.java): `components/apimgt/org.wso2.carbon.apimgt.gateway/src/main/java/org/wso2/carbon/apimgt/gateway/LLMProviderManager.java`

### API management

- [API products](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/APIProduct.java): `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/model/APIProduct.java`
- [Key validation](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.keymgt/src/main/java/org/wso2/carbon/apimgt/keymgt/service/APIKeyValidationService.java): `components/apimgt/org.wso2.carbon.apimgt.keymgt/src/main/java/org/wso2/carbon/apimgt/keymgt/service/APIKeyValidationService.java`
- [Gateway API routes](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.rest.api.gateway/src/gen/java/org/wso2/carbon/apimgt/rest/api/gateway/ApisApiService.java): `components/apimgt/org.wso2.carbon.apimgt.rest.api.gateway/src/gen/java/org/wso2/carbon/apimgt/rest/api/gateway/ApisApiService.java`

### API governance

- [Governance rules API](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.rest.api/src/gen/java/org/wso2/carbon/apimgt/governance/rest/api/RulesetsApiService.java): `components/apimgt/org.wso2.carbon.apimgt.governance.rest.api/src/gen/java/org/wso2/carbon/apimgt/governance/rest/api/RulesetsApiService.java`
- [Governance service](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/service/APIMGovernanceService.java): `components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/service/APIMGovernanceService.java`
- [Validation service](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.impl/src/main/java/org/wso2/carbon/apimgt/governance/impl/validator/ValidationEngineService.java): `components/apimgt/org.wso2.carbon.apimgt.governance.impl/src/main/java/org/wso2/carbon/apimgt/governance/impl/validator/ValidationEngineService.java`
- [Validation contract](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/ValidationEngine.java): `components/apimgt/org.wso2.carbon.apimgt.governance.api/src/main/java/org/wso2/carbon/apimgt/governance/api/ValidationEngine.java`
- [Spectral engine](https://github.com/wso2/carbon-apimgt/blob/master/components/governance/org.wso2.carbon.apimgt.governance.engine/src/main/java/org/wso2/carbon/apimgt/governance/engine/SpectralValidationEngine.java): `components/governance/org.wso2.carbon.apimgt.governance.engine/src/main/java/org/wso2/carbon/apimgt/governance/engine/SpectralValidationEngine.java`
- [Compliance manager](https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.governance.impl/src/main/java/org/wso2/carbon/apimgt/governance/impl/ComplianceManager.java): `components/apimgt/org.wso2.carbon.apimgt.governance.impl/src/main/java/org/wso2/carbon/apimgt/governance/impl/ComplianceManager.java`

### Other components

- **Administrator**
- **API publisher**
- **LLM provider**

## Connections

- Administrator → Provider admin API: manages providers
- API publisher → Provider publisher API: manages providers
- Provider registration → Provider admin contract: uses admin contract (evidence: `components/apimgt/org.wso2.carbon.apimgt.impl/src/main/java/org/wso2/carbon/apimgt/impl/LLMProviderRegistrationService.java`)
- Provider registration → Provider service contract: registers services (evidence: `components/apimgt/org.wso2.carbon.apimgt.impl/src/main/java/org/wso2/carbon/apimgt/impl/LLMProviderRegistrationService.java`)
- Provider registration → Built-in connectors: gets built-in provider (evidence: `components/apimgt/org.wso2.carbon.apimgt.impl/src/main/java/org/wso2/carbon/apimgt/impl/LLMProviderRegistrationService.java`)
- Vertex Anthropic connector → Provider model: builds provider (evidence: `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/VertexAIAnthropicLLMProviderService.java`)
- Vertex Anthropic connector → Provider configuration: sets configuration (evidence: `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/VertexAIAnthropicLLMProviderService.java`)
- Vertex Anthropic connector → Provider metadata: sets metadata (evidence: `components/apimgt/org.wso2.carbon.apimgt.api/src/main/java/org/wso2/carbon/apimgt/api/VertexAIAnthropicLLMProviderService.java`)
- Gateway provider manager → LLM provider: dispatches requests
- Governance rules API → Governance service: routes rules
- Validation service → Validation contract: implements contract (evidence: `components/apimgt/org.wso2.carbon.apimgt.governance.impl/src/main/java/org/wso2/carbon/apimgt/governance/impl/validator/ValidationEngineService.java`)
- Spectral engine → Validation contract: implements contract (evidence: `components/governance/org.wso2.carbon.apimgt.governance.engine/src/main/java/org/wso2/carbon/apimgt/governance/engine/SpectralValidationEngine.java`)
- Compliance manager → Spectral engine: uses validator
