Skip to content

jonnydgreen/terraform-provider-postman

Repository files navigation

Terraform Provider for Postman

The Terraform Postman provider is a plugin that allows Terraform to manage resources in Postman.

WARNING: The Terraform Provider for Postman makes use of the Postman API. Before proceeding, please ensure you have checked your Postman API usage plans on your personal/team account resource usage page within Postman.

Quick Starts

terraform {
  required_providers {
    postman = {
      version = "0.2"
      source  = "jonnydgreen/postman"
    }
  }
}

provider "postman" {}

resource "postman_workspace" "example" {
  name = "Example"
  type = "personal"
}

resource "postman_environment" "example" {
  name      = "Example"
  workspace = postman_workspace.example.id
  values = [
    {
      key   = "hello"
      value = "there"
    },
    {
      key     = "foo"
      value   = "bar"
      enabled = false
      type    = "secret"
    },
  ]
}

Requirements

Supported Features

Feature Resource Data Source Import
Workspaces
Environments
Apis 🚧 🚧 🚧
Collections 🚧 🚧 🚧
Mocks
Monitors

Using the provider

Upgrading the provider

The Postman provider doesn't upgrade automatically once you've started using it.

After a new release you can run

terraform init -upgrade

to upgrade to the latest stable version of the Postman provider. See the Terraform website for more information on provider upgrades, and how to set version constraints on your provider.

Developing the Provider

Contributions are very welcome! :)

See the contributing guide for more details.

Future work

  • Support for APIs
  • Support for Collections
  • Support for Mocks
  • Support for Monitors
  • Support for input validators
  • Support for automated acceptance testing

Acceptance tests ideas

  • Manual Dispatch
  • On main only
  • Or both of the above

About

Terraform Provider for Postman

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published