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

# vantage_folder (Data Source)

> Terraform data source reference for vantage_folder (Data Source). Auto-generated from the vantage-sh/terraform-provider-vantage repository.

<Note>
  This page is auto-generated based on the official [Terraform documentation](https://registry.terraform.io/providers/vantage-sh/vantage/latest/docs).
</Note>

## Overview

Use this data source with the [Vantage Terraform provider](/terraform). For installation and authentication, see the [Terraform provider quickstart](/terraform#quickstart). The schema below is generated directly from the provider source.

***

page\_title: "vantage\_folder Data Source - terraform-provider-vantage"
subcategory: ""
description: |-
Looks up a folder by title.
---------------------------

# vantage\_folder (Data Source)

Looks up a folder by its title. Searches all folders returned by the [Get All Folders](https://docs.vantage.sh/api/folders/get-all-folders) endpoint and returns the first match.

Use `workspace_token` or `parent_folder_token` to narrow the search when multiple folders share the same title.

## Example Usage

```terraform theme={null}
# Look up by title only
data "vantage_folder" "example" {
  title = "Engineering"
}

# Look up by title within a specific workspace
data "vantage_folder" "filtered" {
  title           = "Engineering"
  workspace_token = "wrkspc_1a2b3c4d5e6f"
}

output "folder_token" {
  value = data.vantage_folder.example.token
}
```

## Schema

### Required

* `title` (String) The title of the folder to find.

### Optional

* `workspace_token` (String) Filter folders by workspace token. If not specified, the first folder matching the title is returned. Also populated as an output with the workspace token of the matched folder.
* `parent_folder_token` (String) Filter folders by parent folder token. Set to an empty string (`""`) to match only root-level folders (those with no parent). Also populated as an output with the parent folder token of the matched folder.

### Read-Only

* `token` (String) The unique token of the matched folder.