---
title: "Describe Replay's Variable Data"
method: POST
path: "/variable-data-content/describe"
tags: ["Variable Data Content"]
---

# Describe Replay's Variable Data

`POST /variable-data-content/describe`

## Request

- Base URL: `https://vd-api.picsart.io/v1`
- URL: `https://vd-api.picsart.io/v1/variable-data-content/describe`
- Auth: API key in header `X-Picsart-API-Key`

Describes the Replay. Lists all variable data fields and their types: image, text, etc.

## Request body `multipart/form-data`

- TemplateParameters
  - `template_id` string: Source template ID from Picsart Inventory. (If this parameter is present, the other template source parameters must be empty.)
  - `template` string, binary: Source replay file (binary). (If this parameter is present, the other template source parameters must be empty.)
  - `template_url` string, uri: Source replay URL. (If this parameter is present, the other template source parameters must be empty.)

## Response `200`

Success.

- object
  - `data` object
    - `tags` object[]
      - `type` 'image' | 'text'
      - `tag` string
    - `animated` boolean
  - `status` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `413`: Request Entity Too Large
- `415`: Unsupported Media Type
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `431`: Request Header Fields Too Large
- `500`: Internal Server Error
- `503`: Service Unavailable
- `529`: Overloaded. The model provider is overloaded and could not complete this request. Please retry shortly, or switch to a different model.

---

[API](https://skmtc.dev/picsart/apis/picsart-variable-data-content-apis.md) - [All operations](https://skmtc.dev/picsart/apis/picsart-variable-data-content-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/picsart/apis/picsart-variable-data-content-apis/revisions/34c56ec58738?raw)