> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kosli.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.kosli.com/feedback

```json
{
  "path": "/terraform-reference/data-sources/flow",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# kosli_flow data source

> Fetches details of an existing Kosli flow. Use this data source to reference flow configurations and templates.

Fetches details of an existing Kosli flow. A flow represents a business or software process that requires change tracking.

## Example usage

```terraform theme={"theme":"dracula","languages":{"custom":["/languages/rego.json"]}}
terraform {
  required_providers {
    kosli = {
      source = "kosli-dev/kosli"
    }
  }
}

# Query an existing flow
data "kosli_flow" "example" {
  name = "my-application-flow"
}

# Create a new flow reusing the template from an existing one
resource "kosli_flow" "copy" {
  name        = "my-application-flow-copy"
  description = data.kosli_flow.example.description
  template    = data.kosli_flow.example.template
}

output "flow_name" {
  description = "The name of the flow"
  value       = data.kosli_flow.example.name
}

output "flow_template" {
  description = "The YAML template of the flow"
  value       = data.kosli_flow.example.template
}

output "flow_tags" {
  description = "The tags of the flow"
  value       = data.kosli_flow.example.tags
}
```

## Schema

### Required

* `name` (String) The name of the flow to query.

### Read-only

* `description` (String) The description of the flow.
* `tags` (Map of String) Key-value pairs tagging the flow.
* `template` (String) YAML template defining the flow structure (trails, artifacts, attestations).