---
title: "Assets"
description: "Files, links and licence-key files in the library."
url: https://docs.filemonk.io/v2/api-reference/assets/
api: "API v2 reference"
---

# Assets

Files, links and licence-key files in the library.

## The asset object

- `id` (string, nullable, required): e.g. `e2b7727e-45ad-42b7-b842-cc4615205b10`
- `type` (string, nullable, required): e.g. `link`
- `name` (string, nullable, required): e.g. `ebook-2026`
- `filename` (string, nullable, required): e.g. `ebook-2026.zip`
- `extension` (string, nullable, required): e.g. `zip`
- `content_type` (string, nullable, required): e.g. `application/zip`
- `byte_size` (integer, nullable, required): e.g. `0`
- `url` (string, nullable, required): e.g. `https://example.com/ebook-2026.zip`
- `url_expires_at` (any, required)
- `watermark` (object, required)
  - `enabled` (boolean, nullable, required): e.g. `false`
- `licence_keys` (object, required)
  - `autogenerate` (boolean, nullable, required): e.g. `false`
  - `tags` (array of anys, required)
- `usage` (object, required)
  - `digital_products_count` (integer, nullable, required): e.g. `2`
  - `orders_count` (integer, nullable, required): e.g. `0`
- `digital_products` (array of objects, required)
  - `id` (string, nullable, required): e.g. `f5f278c8-4a92-48a3-bc40-216468b9bccd`
  - `scope` (string, nullable, required): e.g. `variant`
  - `shopify_product_id` (string, nullable, required): e.g. `gid://shopify/Product/9642107207975`
  - `shopify_variant_id` (string, nullable, required): e.g. `gid://shopify/ProductVariant/49417715843367`
  - `title` (string, nullable, required): e.g. `Watercolour Course`
  - `variant_title` (string, nullable, required): e.g. `xs / blue / water`
  - `sku` (string, nullable, required): e.g. `ae8ea669-7bd1-4afd-b200-a7b75777b46a`
  - `files_count` (integer, nullable, required): e.g. `2`
  - `preorder` (object, required)
    - `enabled` (boolean, nullable, required): e.g. `false`
  - `delivery` (object, required)
    - `attach_to_every_order` (boolean, nullable, required): e.g. `false`
  - `exists_on_shopify` (any, required)
  - `updated_at` (string, nullable, required): e.g. `2026-10-30T16:55:48Z`
  - `folder` (any, required)
- `recent_orders` (array of anys, required)
- `created_at` (string, nullable, required): e.g. `2026-10-30T16:49:38Z`
- `updated_at` (string, nullable, required): e.g. `2026-10-30T16:49:38Z`

```json
{
  "id": "e2b7727e-45ad-42b7-b842-cc4615205b10",
  "type": "link",
  "name": "ebook-2026",
  "filename": "ebook-2026.zip",
  "extension": "zip",
  "content_type": "application/zip",
  "byte_size": 0,
  "url": "https://example.com/ebook-2026.zip",
  "url_expires_at": null,
  "watermark": {
    "enabled": false
  },
  "licence_keys": {
    "autogenerate": false,
    "tags": []
  },
  "usage": {
    "digital_products_count": 2,
    "orders_count": 0
  },
  "digital_products": [
    {
      "id": "f5f278c8-4a92-48a3-bc40-216468b9bccd",
      "scope": "variant",
      "shopify_product_id": "gid://shopify/Product/9642107207975",
      "shopify_variant_id": "gid://shopify/ProductVariant/49417715843367",
      "title": "Watercolour Course",
      "variant_title": "xs / blue / water",
      "sku": "ae8ea669-7bd1-4afd-b200-a7b75777b46a",
      "files_count": 2,
      "preorder": {
        "enabled": false
      },
      "delivery": {
        "attach_to_every_order": false
      },
      "exists_on_shopify": null,
      "updated_at": "2026-10-30T16:55:48Z",
      "folder": null
    },
    {
      "id": "4d08443e-549b-44c8-afee-c3836d767e7c",
      "scope": "product",
      "shopify_product_id": "gid://shopify/Product/9642103537959",
      "shopify_variant_id": null,
      "title": "The Draft Snowboard",
      "variant_title": null,
      "sku": null,
      "files_count": 2,
      "preorder": {
        "enabled": false
      },
      "delivery": {
        "attach_to_every_order": false
      },
      "exists_on_shopify": null,
      "updated_at": "2026-10-30T16:56:48Z",
      "folder": "Extras"
    }
  ],
  "recent_orders": [],
  "created_at": "2026-10-30T16:49:38Z",
  "updated_at": "2026-10-30T16:49:38Z"
}
```

## Endpoints

- `GET /assets`: [List assets](https://docs.filemonk.io/v2/api-reference/assets/list-assets.md)
- `POST /assets`: [Create a file](https://docs.filemonk.io/v2/api-reference/assets/create-a-file.md)
- `GET /assets/{id}`: [Get a file](https://docs.filemonk.io/v2/api-reference/assets/get-a-file.md)
- `PATCH /assets/{id}`: [Update a file](https://docs.filemonk.io/v2/api-reference/assets/update-a-file.md)
- `DELETE /assets/{id}`: [Delete a file](https://docs.filemonk.io/v2/api-reference/assets/delete-a-file.md)
- `GET /assets/{id}/linked_orders`: [List orders a file is on](https://docs.filemonk.io/v2/api-reference/assets/list-orders-a-file-is-on.md)
- `POST /assets/{id}/replace`: [Replace a file](https://docs.filemonk.io/v2/api-reference/assets/replace-a-file.md)
- `POST /assets/bulk_delete`: [Bulk delete files](https://docs.filemonk.io/v2/api-reference/assets/bulk-delete-files.md)