---
title: "Assets"
description: "Assets: List assets, Create an asset, Get an asset, Update an asset, Delete an asset, Replace an asset's file."
url: https://docs.filemonk.io/api-reference/assets/
api: "API v1 reference"
---

# Assets

## The asset object

- `asset` (object)
  - `id` (string): Unique asset identifier
  - `type` (string): The asset type. `internal` for uploaded files, `external` for URL-based assets, `licence` for licence key assets. One of: `internal`, `external`, `licence`.
  - `name` (string, nullable): Display name of the asset.
  - `filename` (string, nullable): Filename of the asset (derived from the file or URL).
  - `external_url` (string, nullable): The external URL for `external` type assets. `null` for other types.
  - `content_type` (string, nullable): MIME type of the asset.
  - `byte_size` (integer): File size in bytes. `0` for external and licence assets.
  - `watermark_asset` (boolean): Whether watermarking is enabled for this asset (PDFs only).
  - `autogenerate_licence_key` (boolean): Whether a licence key is auto-generated when this asset is purchased.
  - `created_at` (string): When the asset was created.
  - `updated_at` (string): When the asset was last updated.

```json
{
  "asset": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "external",
    "name": "Photoshop Brushes Pack",
    "filename": "brushes-pack-v2.zip",
    "external_url": "https://cdn.example.com/files/brushes-pack-v2.zip",
    "content_type": "application/zip",
    "byte_size": 0,
    "watermark_asset": false,
    "autogenerate_licence_key": false,
    "created_at": "2026-01-15T09:30:00Z",
    "updated_at": "2026-01-15T09:30:00Z"
  }
}
```

## Endpoints

- `GET /assets`: [List assets](https://docs.filemonk.io/api-reference/assets/list-assets.md)
- `POST /assets`: [Create an asset](https://docs.filemonk.io/api-reference/assets/upload-asset.md)
- `GET /assets/{id}`: [Get an asset](https://docs.filemonk.io/api-reference/assets/get-asset.md)
- `PATCH /assets/{id}`: [Update an asset](https://docs.filemonk.io/api-reference/assets/update-asset.md)
- `DELETE /assets/{id}`: [Delete an asset](https://docs.filemonk.io/api-reference/assets/delete-asset.md)
- `POST /assets/{id}/replace`: [Replace an asset's file](https://docs.filemonk.io/api-reference/assets/replace-asset.md)