Terraform provider reference

The agynio/terraform-provider-agyn provider exposes every Gateway resource as a Terraform resource or data source. This page is a pointer to its full reference; for the user-facing introduction, see Administer → Terraform and Build & extend → Terraform provider.

Where the docs live

The full provider reference is generated from the provider's source and published on the Terraform Registry once each release ships:

Each resource page on the Registry includes:

  • Argument reference (every field, type, required/optional, in-place vs. force-new).
  • Attribute reference (computed outputs).
  • Import syntax.
  • Example usage.

Resource list at a glance

ResourceService backing it
agyn_organizationOrganizations
agyn_organization_memberOrganizations
agyn_cluster_adminAuthorization (tuple write)
agyn_agentAgents
agyn_agent_roleAuthorization (tuple write)
agyn_agent_mcpAgents
agyn_agent_skillAgents
agyn_agent_hookAgents
agyn_agent_envAgents
agyn_agent_init_scriptAgents
agyn_agent_volume_attachmentAgents
agyn_agent_image_pull_secret_attachmentAgents
agyn_volumeAgents
agyn_image_pull_secretSecrets
agyn_llm_providerLLM
agyn_llm_modelLLM
agyn_secret_providerSecrets
agyn_secretSecrets
agyn_runnerRunners
agyn_appApps
agyn_app_installationApps

Data sources

Data sourcePurpose
agyn_userLook up a user by username or OIDC subject.
agyn_agentLook up an agent by name.
agyn_appLook up a published app by slug.
agyn_organizationLook up an organization by name.
agyn_runnerLook up a registered runner.

Provider configuration

hcl
provider "agyn" {
  gateway = "https://gateway.agyn.example.com"
  token   = var.agyn_api_token
}
ArgumentDescription
gatewayGateway endpoint URL.
tokenAPI token (or AGYN_TOKEN env var).
insecure_skip_verifySkip TLS verification — dev only.

Versioning

The provider follows semantic versioning. The platform chart's release notes call out the minimum compatible provider version. Pin in your config:

hcl
terraform {
  required_providers {
    agyn = {
      source  = "agynio/agyn"
      version = "~> 1.0"
    }
  }
}