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

# Get asset

> GET /v1/assets/{virtual_id}

## Introduction

Get one asset and refresh upstream processing status. Confirm `status: active` before video generation.

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer Token, e.g. `Bearer sk-xxxxxxxxxx`
</ParamField>

## Path parameters

<ParamField path="virtual_id" type="string" required>
  Asset ID (e.g. `asset-20260508120145-pqwhc`; matches the part after `asset://`)
</ParamField>

## Example

```bash theme={null}
curl "https://api.gravitex.ai/v1/assets/asset-20260508120145-pqwhc" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"
```

## Status

| status    | Meaning                                                        |
| --------- | -------------------------------------------------------------- |
| `pending` | Upstream processing (including face recognition); keep polling |
| `active`  | Ready for `asset://` in video generation                       |
| `failed`  | Processing failed; check specs and re-upload                   |

> The gateway verifies asset ownership; you can only use assets you uploaded.