# mypurecloud/terraform-provider-genesyscloud architecture

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

- Interactive diagram: https://gitdiagram.com/mypurecloud/terraform-provider-genesyscloud
- Repository: https://github.com/mypurecloud/terraform-provider-genesyscloud

## Overview

This repository is a Terraform provider for managing Genesys Cloud configuration. The main workflow is that an operator declares provider credentials and resources or data sources in Terraform; the provider performs CRUD or read-only lookups through Genesys Cloud’s public APIs and returns state for Terraform. Resource families span routing, Architect, identity and access, messaging, and other platform capabilities. The sampled files show OAuth-client and routing implementations; relationships for other listed families are limited to documented provider behavior. Export tooling is represented only where the tree supports a source path.

Main entry points: [`main.go`](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/main.go) (Provider entry), [`genesyscloud`](https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud) (Read-only data sources), [`genesyscloud/routing_queue/resource_genesyscloud_routing_queue.go`](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_queue/resource_genesyscloud_routing_queue.go) (Routing queues), [`genesyscloud/oauth_client/resource_genesyscloud_oauth_client.go`](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/oauth_client/resource_genesyscloud_oauth_client.go) (OAuth clients)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provider["Provider runtime"]
  node_provider_entry["Provider entry<br/>[main.go]"]
  node_sdk_pool["SDK client pool<br/>[sdk_client_pool.go]"]
  node_custom_api["Custom API client"]
  node_consistency["Consistency checker"]
  node_data_sources["Read-only data sources"]
  node_exporter["Resource export<br/>[main.go]"]
end

subgraph group_routing["Routing management"]
  node_routing_queue["Routing queues"]
  node_routing_email["Email routing"]
  node_routing_skills["Routing skills"]
  node_routing_settings["Routing settings"]
  node_routing_wrapup["Wrap-up codes"]
end

subgraph group_platform["Platform resources"]
  node_architect["Architect resources"]
  node_messaging["Messaging resources"]
  node_business_rules["Business rules"]
  node_case_plans["Case management"]
end

subgraph group_identity["Identity access"]
  node_oauth_client["OAuth clients"]
  node_oauth_proxy["OAuth API proxy"]
  node_auth_roles["Authorization roles"]
end

node_operator(("Terraform operator"))
node_terraform(("Terraform CLI"))
node_genesys_api{{"Genesys Cloud APIs"}}

node_operator -->|"declares config"| node_terraform
node_terraform -.->|"loads provider"| node_provider_entry
node_terraform -->|"configures resource"| node_routing_queue
node_terraform -->|"configures resource"| node_oauth_client
node_terraform -->|"references data"| node_data_sources
node_provider_entry -.->|"uses clients"| node_sdk_pool
node_routing_queue -->|"CRUD calls"| node_genesys_api
node_routing_email -->|"CRUD calls"| node_genesys_api
node_routing_skills -->|"CRUD calls"| node_genesys_api
node_routing_settings -->|"updates settings"| node_genesys_api
node_routing_wrapup -->|"CRUD calls"| node_genesys_api
node_architect -->|"manages resources"| node_genesys_api
node_messaging -->|"manages resources"| node_genesys_api
node_business_rules -->|"manages resources"| node_genesys_api
node_case_plans -->|"manages resources"| node_genesys_api
node_auth_roles -->|"manages resources"| node_genesys_api
node_oauth_client -->|"calls proxy"| node_oauth_proxy
node_oauth_proxy -->|"OAuth requests"| node_genesys_api
node_data_sources -->|"reads resources"| node_genesys_api
node_exporter -.->|"exports resources"| node_genesys_api

click node_provider_entry "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/main.go"
click node_sdk_pool "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/provider/sdk_client_pool.go"
click node_custom_api "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/custom_api_client/custom_api_client.go"
click node_consistency "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/consistency_checker/consistency_checker.go"
click node_routing_queue "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_queue/resource_genesyscloud_routing_queue.go"
click node_routing_email "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_email_route/resource_genesyscloud_routing_email_route.go"
click node_routing_skills "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_skill_group/resource_genesyscloud_routing_skill_group.go"
click node_routing_settings "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_settings/resource_genesyscloud_routing_settings.go"
click node_routing_wrapup "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_wrapupcode/genesyscloud_routing_wrapupcode_proxy.go"
click node_architect "https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/architect_flow"
click node_messaging "https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/conversations_messaging_integrations_whatsapp"
click node_business_rules "https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/business_rules_decision_table"
click node_case_plans "https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/case_management_caseplan"
click node_oauth_client "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/oauth_client/resource_genesyscloud_oauth_client.go"
click node_oauth_proxy "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/oauth_client/resource_genesyscloud_oauth_client_proxy.go"
click node_auth_roles "https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/auth_role"
click node_data_sources "https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud"
click node_exporter "https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/mrmo/exporter/main.go"

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_provider_entry,node_sdk_pool,node_custom_api,node_consistency,node_data_sources,node_exporter toneBlue
class node_routing_queue,node_routing_email,node_routing_skills,node_routing_settings,node_routing_wrapup toneAmber
class node_architect,node_messaging,node_business_rules,node_case_plans,node_genesys_api toneMint
class node_oauth_client,node_oauth_proxy,node_auth_roles toneRose
class node_operator,node_terraform toneIndigo
```

## Components

### Provider runtime

- [Provider entry](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/main.go): `main.go`
- [SDK client pool](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/provider/sdk_client_pool.go): `genesyscloud/provider/sdk_client_pool.go`
- [Custom API client](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/custom_api_client/custom_api_client.go): `genesyscloud/custom_api_client/custom_api_client.go`
- [Consistency checker](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/consistency_checker/consistency_checker.go): `genesyscloud/consistency_checker/consistency_checker.go`
- [Read-only data sources](https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud): `genesyscloud`
- [Resource export](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/mrmo/exporter/main.go): `genesyscloud/mrmo/exporter/main.go`

### Routing management

- [Routing queues](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_queue/resource_genesyscloud_routing_queue.go): `genesyscloud/routing_queue/resource_genesyscloud_routing_queue.go`
- [Email routing](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_email_route/resource_genesyscloud_routing_email_route.go): `genesyscloud/routing_email_route/resource_genesyscloud_routing_email_route.go`
- [Routing skills](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_skill_group/resource_genesyscloud_routing_skill_group.go): `genesyscloud/routing_skill_group/resource_genesyscloud_routing_skill_group.go`
- [Routing settings](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_settings/resource_genesyscloud_routing_settings.go): `genesyscloud/routing_settings/resource_genesyscloud_routing_settings.go`
- [Wrap-up codes](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/routing_wrapupcode/genesyscloud_routing_wrapupcode_proxy.go): `genesyscloud/routing_wrapupcode/genesyscloud_routing_wrapupcode_proxy.go`

### Platform resources

- [Architect resources](https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/architect_flow): `genesyscloud/architect_flow`
- [Messaging resources](https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/conversations_messaging_integrations_whatsapp): `genesyscloud/conversations_messaging_integrations_whatsapp`
- [Business rules](https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/business_rules_decision_table): `genesyscloud/business_rules_decision_table`
- [Case management](https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/case_management_caseplan): `genesyscloud/case_management_caseplan`

### Identity access

- [OAuth clients](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/oauth_client/resource_genesyscloud_oauth_client.go): `genesyscloud/oauth_client/resource_genesyscloud_oauth_client.go`
- [OAuth API proxy](https://github.com/mypurecloud/terraform-provider-genesyscloud/blob/main/genesyscloud/oauth_client/resource_genesyscloud_oauth_client_proxy.go): `genesyscloud/oauth_client/resource_genesyscloud_oauth_client_proxy.go`
- [Authorization roles](https://github.com/mypurecloud/terraform-provider-genesyscloud/tree/main/genesyscloud/auth_role): `genesyscloud/auth_role`

### Other components

- **Terraform operator**
- **Terraform CLI**
- **Genesys Cloud APIs**

## Connections

- Terraform operator → Terraform CLI: declares config
- Terraform CLI → Provider entry: loads provider
- Terraform CLI → Routing queues: configures resource
- Terraform CLI → OAuth clients: configures resource
- Terraform CLI → Read-only data sources: references data
- Provider entry → SDK client pool: uses clients
- Routing queues → Genesys Cloud APIs: CRUD calls
- Email routing → Genesys Cloud APIs: CRUD calls
- Routing skills → Genesys Cloud APIs: CRUD calls
- Routing settings → Genesys Cloud APIs: updates settings
- Wrap-up codes → Genesys Cloud APIs: CRUD calls (evidence: `genesyscloud/routing_wrapupcode/genesyscloud_routing_wrapupcode_proxy.go`)
- Architect resources → Genesys Cloud APIs: manages resources
- Messaging resources → Genesys Cloud APIs: manages resources
- Business rules → Genesys Cloud APIs: manages resources
- Case management → Genesys Cloud APIs: manages resources
- Authorization roles → Genesys Cloud APIs: manages resources
- OAuth clients → OAuth API proxy: calls proxy (evidence: `genesyscloud/oauth_client/resource_genesyscloud_oauth_client.go`)
- OAuth API proxy → Genesys Cloud APIs: OAuth requests (evidence: `genesyscloud/oauth_client/resource_genesyscloud_oauth_client_proxy.go`)
- Read-only data sources → Genesys Cloud APIs: reads resources
- Resource export → Genesys Cloud APIs: exports resources
