Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion terraform-reference/index.mdx
Original file line number Diff line number Diff line change
@@ -1,15 +1,19 @@
---
title: "Kosli Terraform Provider"

Check warning on line 2 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L2

Did you really mean 'Kosli'?
description: "Manage Kosli resources as Infrastructure-as-Code using Terraform."

Check warning on line 3 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L3

Did you really mean 'Kosli'?
icon: "layer-group"
---

The Kosli provider allows you to manage Kosli resources as Infrastructure-as-Code using Terraform. Use it to define and manage custom attestation types and integrate Kosli into your compliance workflows. The provider is officially registered at the [Terraform Registry](https://registry.terraform.io/providers/kosli-dev/kosli/latest).
The Kosli provider allows you to manage Kosli resources as Infrastructure-as-Code using Terraform. Use it to define and manage custom attestation types and integrate Kosli into your compliance workflows.

Check warning on line 7 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L7

Did you really mean 'Kosli'?

Check warning on line 7 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L7

Did you really mean 'Kosli'?

Check warning on line 7 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L7

Did you really mean 'Kosli'?

<Note>
The provider is officially registered at the [Terraform Registry](https://registry.terraform.io/providers/kosli-dev/kosli/latest/docs).
</Note>

## Requirements

- Terraform >= 1.10
- A Kosli account with API credentials

Check warning on line 16 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L16

Did you really mean 'Kosli'?

## Example usage

Expand Down Expand Up @@ -38,7 +42,7 @@

## Authentication

The provider requires a Kosli API token and organization name for authentication. These can be configured in two ways (in order of precedence):

Check warning on line 45 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L45

Did you really mean 'Kosli'?

1. **Provider configuration** - Set directly in your Terraform configuration
2. **Environment variables** - Use `KOSLI_API_TOKEN` and `KOSLI_ORG`
Expand All @@ -53,12 +57,12 @@
4. Copy the token and store it securely

<Warning>
API tokens grant full access to your Kosli organization. Store them securely and never commit them to version control.

Check warning on line 60 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L60

Did you really mean 'Kosli'?
</Warning>

## Regional endpoints

Kosli operates in multiple regions. Configure the `api_url` to match your organization's region:

Check warning on line 65 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L65

Did you really mean 'Kosli'?

- **EU (Default)**: `https://app.kosli.com`
- **US**: `https://app.us.kosli.com`
Expand All @@ -67,7 +71,7 @@

### Optional

- `api_token` (String, Sensitive) Kosli API token for authentication. Can also be set via KOSLI_API_TOKEN environment variable.

Check warning on line 74 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L74

Did you really mean 'Kosli'?
- `api_url` (String) Kosli API endpoint URL. Defaults to https://app.kosli.com (EU region). Use https://app.us.kosli.com for US region. Can also be set via KOSLI_API_URL environment variable.

Check warning on line 75 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L75

Did you really mean 'Kosli'?
- `org` (String) Kosli organization name. Can also be set via KOSLI_ORG environment variable.

Check warning on line 76 in terraform-reference/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (kosli) - vale-spellcheck

terraform-reference/index.mdx#L76

Did you really mean 'Kosli'?
- `timeout` (Number) HTTP client timeout in seconds. Defaults to 30 seconds.