> ## 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_canvas (Resource)

> Terraform resource reference for vantage_canvas (Resource). 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 resource 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.

Manages a Canvas.

## Example Usage

```terraform theme={null}
data "vantage_workspaces" "demo" {}

resource "vantage_canvas" "demo" {
  title           = "Monthly Cost Overview"
  prompt          = "Show me monthly costs by provider"
  workspace_token = element(data.vantage_workspaces.demo.workspaces, 0).token
}
```

## Schema

### Required

* `prompt` (String) The prompt used to generate the Canvas.
* `title` (String) The title of the Canvas.

### Optional

* `workspace_token` (String) The token of the Workspace to add the Canvas to. Required if the API token is associated with multiple Workspaces.

### Read-Only

* `created_at` (String) The date and time, in UTC, the Canvas was created. ISO 8601 Formatted.
* `data` (Attributes) The structured table data of the Canvas. (see [below for nested schema](#nestedatt--data))
* `id` (String) The id of the canvas
* `token` (String) The token of the canvas
* `updated_at` (String) The date and time, in UTC, the Canvas was last updated. ISO 8601 Formatted.

<a id="nestedatt--data" />

### Nested Schema for `data`

Read-Only:

* `error` (String) Error message if the refresh workflow failed.
* `table` (String) JSON-encoded tabular data produced by the Canvas refresh workflow.