API Changelog

Keep track of changes to the API for Terraform Cloud and Terraform Enterprise.

2022-06-21

• Updated Admin Organizations endpoints with new workspace-limit setting. This is available in Terraform Enterprise v202207-1 and later.

2022-06-17

• Updated Creating a Run Task section to include the new description information for the run task to be configured.
• Update Run Tasks to include the new description attribute.

2022-06-09

• Updated List Agent Pools to accept a search parameter q, so that agent pools can be searched by name. This is available in Terraform Enterprise v202207-1 and later.
• Fixed List Workspaces to add missing search[tags] query parameter.
• Updated List Workspaces to add new search[exclude_tags] query parameter. This is available in Terraform Enterprise v202207-1 and later.

2022-05-11

• Updated Run Tasks permission to the following endpoints:
  • Organizations.
  • Team Access.
  • Teams.

2022-05-04

• Updated Feature Sets to add new run-tasks attribute.

2022-05-03

• Added Run Tasks permission to the following endpoints:
  • Organizations
  • Workspaces

2022-04-29

• Updated Run Tasks Integration to specify the allowed status attribute values.
• Updated Organization Memberships to add new filter[email] query parameter.
• Updated Teams to add new filter[names] query parameter.

2022-04-04

• Added the Run Tasks Integration endpoint.

2022-03-14

• Added the Download Configuration Files endpoints.

2022-03-11

• Introduced Archiving Configuration Versions.
  • Updated Configuration Versions to add new fetching and archived states.
  • Updated Runs to add new fetching state.
  • Added the Archive a Configuration Version endpoint.

2022-02-25

• Updated Workspace Run Tasks to add new enabledattribute.

2022-02-28

• Introduced the Registry Providers endpoints to manage private providers for a private registry.

2021-12-09

• Added variables field for POST /runs and the run resource, enabling run-specific variable values.

2021-12-03

• OAuth API updated to handle secret and rsa_public_key fields for POST/PUT.

2021-11-17

• Added pagination support to the following endpoints:
  • Feature Sets - GET /feature-sets
  • Notification Configurations - GET /workspaces/:workspace_id/notification-configurations
  • Oauth Clients - GET /organizations/:organization_name/oauth-clients
  • Oauth Tokens - GET /oauth-clients/:oauth_client_id/oauth-tokens
  • Organization Feature Sets - GET /organizations/:organization_name/feature-sets
  • Organizations - GET /organizations
  • Policy Checks - GET /runs/:run_id/policy-checks
  • Policy Set Parameters - GET /policy-sets/:policy_set_id/parameters
  • SSH Keys - GET /organizations/:organization_name/ssh-keys
  • User Tokens - GET /users/:user_id/authentication-tokens

2021-11-11

• Introduced the Variable Sets endpoints for viewing and administering Variable Sets

2021-11-18

• Introduced the Registry Providers endpoint to manage public providers for a private registry. These endpoints will be available in the following TFE Release: v202112-1

2021-09-12

• Added Run Tasks Stages and Results endpoint.

2021-08-18

• Introduced the State Version Outputs endpoint to retrieve the Outputs for a given State Version

2021-08-11

• BREAKING CHANGE: Security fix to Configuration versions: upload-url attribute for uploading configuration files is now only available on the create response.

2021-07-30

• Introduced Workspace Tagging
  • Updated Workspaces:
    • added tag-names attribute.
    • added POST /workspaces/:workspace_id/relationships/tags
    • added DELETE /workspaces/:workspace_id/relationships/tags
  • Added Organization Tags.
  • Added tags attribute to tfrun

2021-07-19

• Notification configurations: Gave organization tokens permission to create and manage notification configurations.

2021-07-09

• State versions: Fixed the ID format for the workspace relationship of a state version. Previously, the reported ID was unusable due to a bug.
• Workspaces: Added locked_by as an includable related resource.
• Added Run Tasks API endpoint.

2021-06-8

• Updated Registry Module APIs.
  • added registry_name scoped APIs.
  • added organization_name scoped APIs.
  • added Module List API.
  • updated Module Delete APIs (see deprecation note below).
  • CLOUD: added public registry module related APIs.
• DEPRECATION: The following Registry Module APIs have been replaced with newer apis and will be removed in the future.
  • The following endpoints to delete modules are replaced with Module Delete APIs
    • POST /registry-modules/actions/delete/:organization_name/:name/:provider/:version replaced with DELETE /organizations/:organization_name/registry-modules/:registry_name/:namespace/:name/:provider/:version
    • POST /registry-modules/actions/delete/:organization_name/:name/:provider replaced with DELETE /organizations/:organization_name/registry-modules/:registry_name/:namespace/:name/:provider
    • POST /registry-modules/actions/delete/:organization_name/:name replaced with DELETE /organizations/:organization_name/registry-modules/:registry_name/:namespace/:name
  • POST /registry-modules replaced with POST /organizations/:organization_name/registry-modules/vcs
  • POST /registry-modules/:organization_name/:name/:provider/versions replaced with POST /organizations/:organization_name/registry-modules/:registry_name/:namespace/:name/:provider/versions
  • GET /registry-modules/show/:organization_name/:name/:provider replaced with GET /organizations/:organization_name/registry-modules/:registry_name/:namespace/:name/:provider

2021-05-27

• CLOUD: Agents: added delete endpoint.

2021-05-19

• Runs: added refresh, refresh-only, and replace-addrs attributes.

2021-04-16

• Introduced Controlled Remote State Access.
  • Admin Settings: added default-remote-state-access attribute.
  • Workspaces:
    • added global-remote-state attribute.
    • added Remote State Consumers relationship.

2021-04-13

• Teams: added manage-policy-overrides property to the organization-access attribute.

2021-03-23

• ENTERPRISE: v202103-1 Introduced Share Modules Across Organizations with Terraform Enterprise.
  • Admin Organizations:
    • added new query parameters to List all Organizations endpoint
    • added module-consumers link in relationships response
    • added update module consumers endpoint
    • added list module consumers endpoint
  • Organizations: added Module Producers
  • DEPRECATION: Admin Module Sharing: is replaced with a new JSON::Api compliant endpoint

2021-03-18

• CLOUD: Introduced New Workspace Overview for Terraform Cloud.
  • Workspaces:
    • added resource-count and updated-at attributes.
    • added performance attributes (apply-duration-average, plan-duration-average, policy-check-failures, run-failures, workspaces-kpis-run-count).
    • added readme and outputs related resources.
  • Team Access: updated to support pagination.

2021-03-11

• Added VCS Events, limited to GitLab.com connections.

2021-03-08

• Workspaces: added current_configuration_version and current_configuration_version.ingress_attributes as includable related resources.