---
title: "GET /v1/brand-templates/{brandTemplateId}/dataset"
method: GET
path: "/v1/brand-templates/{brandTemplateId}/dataset"
tags: ["brand_template"]
---

# GET /v1/brand-templates/{brandTemplateId}/dataset

`GET /v1/brand-templates/{brandTemplateId}/dataset`

WARNING: Brand templates were migrated to use a new ID format in September 2025. If your integration stores brand template IDs, you'll need to migrate to use the new IDs. Old brand template IDs will continue to be accepted for 6 months to give you time to migrate to the new IDs.

AVAILABILITY: To use this API, your integration must act on behalf of a user that's on a Canva plan with access to brand templates (such as Canva Pro, Canva Teams, or Canva Enterprise).

Gets the dataset definition of a brand template. If the brand
template contains autofill data fields, this API returns an object with the data field
names and the type of data they accept.

<Note>

To get the dataset definition of a design, use the
[Get design dataset API](https://www.canva.dev/docs/connect/api-reference/designs/get-design-dataset/).

</Note>

Available data field types include:

- Images (which you can autofill with an image or a video asset)
- Text
- Charts

You can autofill a brand template using the [Create a design autofill job
API](https://www.canva.dev/docs/connect/api-reference/autofills/create-design-autofill-job/).

WARNING: Chart data fields and autofilling a video are [preview features](https://www.canva.dev/docs/connect/#preview-apis). There might be unannounced breaking changes to these features which won't produce a new API version.

## Path parameters

- `brandTemplateId` string, required

## Response `200`

OK

- GetBrandTemplateDatasetResponse — Successful response from a `getBrandTemplateDataset` request.
  - `dataset` object — The dataset definition. It contains the data inputs available for use with the [Create design autofill job API](https://www.canva.dev/docs/connect/api-reference/autofills/create-design-autofill-job/).

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `default` — Error Response

---

[API](https://skmtc.net/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.net/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/canva/canva-connect-api/revisions/360bf0176ab2/schema)