[mintlify]

Summary

Sync the Terraform reference with provider releases v0.10.1 and v0.10.2.

Changes

• Overview: add Required permissions (Admin role needed), https-only api_url note, and Telemetry section covering the new X-Kosli-* headers (v0.10.2).
• kosli_environment and kosli_logical_environment: add a note and a Destroying section explaining that destroy archives the environment and requires an Admin token (v0.10.1).

Context

Upstream: terraform-provider-kosli #286, #289, #293.

[claude]

Claude finished @mintlify[bot]'s task in 1m 0s —— View job

---

Doc review

terraform-reference/index.mdx

• Improvement — terraform-reference/index.mdx:60: The <Warning> says API tokens grant "full access to your Kosli organization". The new Required permissions section says a Member token can't archive environments, so the two contradict each other. Reword the warning to say a token has the permissions of its owner's role. This page is synced by an agent from kosli-dev/terraform-provider-kosli, so make the same change there too, or the next sync will bring the old wording back.
• Suggestion — terraform-reference/index.mdx:84: The X-Kosli-Client example uses terraform/v0.11.0. This PR syncs v0.10.2, and the changelog has no v0.11.0 release. Use a released version.

All the new internal links resolve, including /terraform-reference#required-permissions, service_account and service_account_api_key. No pages were added, moved or renamed.

1 Improvement, 1 Suggestion. Neither blocks the merge. This review is advisory.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
kosli	🟢 Ready	View Preview	Oct 29, 2026, 12:02 PM

[claude]

Improvement: The new Required permissions section says a Member token can't archive environments. This warning still says every API token grants "full access to your Kosli organization", so the page now contradicts itself, and a reader may skip the role check. Reword it to describe the token's access in terms of its owner's role, and make the same change in the upstream terraform-provider-kosli docs so the next sync doesn't bring the old wording back.

Suggested change

	API tokens grant full access to your Kosli organization. Store them securely and never commit them to version control.
	API tokens grant access to your Kosli organization with the permissions of the user or service account that owns them. Store them securely and never commit them to version control.

[claude]

Suggestion: This example uses terraform/v0.11.0, but this PR syncs v0.10.2 and the changelog has no v0.11.0 release. Use a released version such as terraform/v0.10.2 so readers don't think a newer provider exists. If the example came from upstream, fix it there as well.