# Bynder

> Work with your Bynder assets: find, upload, update and delete assets, get download links, tag assets, set metaproperties, and create, fill and share collections.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/bynder

## Actions

### Add assets to collection

Add assets to a collection.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id from an earlier step.
- Assets (`asset_ids`, list, required): The assets. Pick from the most recently changed, or give ids from an earlier step (up to 500).

**Outputs**

- `asset_ids` (list): The assets' ids
- `collection_id` (text): The collection's id
- `count` (number): How many assets were sent
- `message` (text): Bynder's answer, such as Accepted

**Example output**

```json
{
  "asset_ids": [
    "8EC04DC8-F7FE-4D2D-BE2F2789A632393D"
  ],
  "collection_id": "00B627BB-8054-44C0-A343FCF40BC790CD",
  "count": 1,
  "message": "Assets added to collection"
}
```

### Add tag to assets

Add one tag to several assets, keeping their other tags.

**Inputs**

- Tag (`tag_id`, text, required): The tag. Pick one, or give its id from 'List tags'. To use a new tag, set it on an asset with 'Update asset' first.
- Assets (`asset_ids`, list, required): The assets. Pick from the most recently changed, or give ids from an earlier step (up to 500).

**Outputs**

- `asset_ids` (list): The assets' ids
- `count` (number): How many assets were sent
- `message` (text): Bynder's answer, such as Accepted
- `tag_id` (text): The tag's id

**Example output**

```json
{
  "asset_ids": [
    "8EC04DC8-F7FE-4D2D-BE2F2789A632393D"
  ],
  "count": 1,
  "message": "Accepted",
  "tag_id": "4C2B1A3D-5E6F-4A7B-8C9D0E1F2A3B4C5D"
}
```

### Create collection

Create a collection to gather assets in.

**Inputs**

- Name (`name`, text, required): The collection's name.
- Description (`description`, text): What the collection is for.

**Outputs**

- `collection` (object): The new collection
- `collection_id` (text): The new collection's id, found by its name; empty if Bynder didn't list it yet
- `message` (text): Bynder's answer, such as Accepted

**Example output**

```json
{
  "collection": {
    "collectionCount": 2,
    "cover": {
      "large": "https://acme.bynder.com/collections/spring/large.jpg",
      "thumbnail": "https://acme.bynder.com/collections/spring/thumb.jpg"
    },
    "dateCreated": "March, 01 2026 10:49:12 +0000",
    "dateModified": "March, 08 2026 14:17:37 +0000",
    "description": "Assets for the spring campaign.",
    "id": "00B627BB-8054-44C0-A343FCF40BC790CD",
    "isPublic": false,
    "name": "Spring campaign",
    "user": {
      "id": "48817BA7-2FC3-4A43-918761514D322C15",
      "name": "Jo Bloggs"
    },
    "userId": "48817BA7-2FC3-4A43-918761514D322C15"
  },
  "collection_id": "00B627BB-8054-44C0-A343FCF40BC790CD",
  "message": "Created"
}
```

### Delete asset

Delete an asset. Bynder keeps it in its recently removed list for 30 days.

**Inputs**

- Asset (`asset_id`, text, required): The asset. Pick one of the most recently changed, or give its id from an earlier step.

**Outputs**

- `asset_id` (text): The asset deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "asset_id": "8EC04DC8-F7FE-4D2D-BE2F2789A632393D",
  "deleted": true
}
```

### Delete collection

Delete a collection. Its assets stay in the portal.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id from an earlier step.

**Outputs**

- `collection_id` (text): The collection deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "collection_id": "00B627BB-8054-44C0-A343FCF40BC790CD",
  "deleted": true
}
```

### Find assets

Find assets by keyword, brand, collection, type, tags, metaproperty options and when they were added or changed.

**Inputs**

- Keyword (`keyword`, text): Words to search for in names, tags, file extensions, collection names and document text.
- Brand (`brand_id`, text): Only assets of this brand.
- Sub-brand (`sub_brand_id`, text): Only assets of this sub-brand.
- Collection (`collection_id`, text): Only assets in this collection.
- Asset types (`asset_types`, list): Only assets of these types. Leave empty for every type. One or more of: `image`, `document`, `video`, `audio`, `3d`.
- Tags (`tags`, list): Only assets with every one of these tags.
- Metaproperty options (`option_ids`, list): Only assets with these metaproperty options, such as Country: France.
- Added after (`created_after`, date and time): Only assets added after this.
- Added before (`created_before`, date and time): Only assets added before this. Needs 'Added after' too.
- Changed after (`modified_after`, date and time): Only assets changed after this.
- Changed before (`modified_before`, date and time): Only assets changed before this. Needs 'Changed after' too.
- Public only (`is_public`, true/false): On: only public assets.
- Archived (`archived`, true/false): On: only archived assets. Off: only assets not archived. Leave unset for both.
- Order (`order_by`, text): How to sort them. One of: `dateCreated desc` (Newest first), `dateCreated asc` (Oldest first), `dateModified desc` (Most recently changed first), `dateModified asc` (Least recently changed first), `datePublished desc` (Most recently published first), `datePublished asc` (Earliest published first), `name asc` (Name, A to Z), `name desc` (Name, Z to A).
- Page size (`limit`, number): How many to return, 1 to 1000. Bynder's default is 50. From 1 to 1000.
- Page (`page`, number): Which page of results, from 1. Leave empty for the first. At least 1.

**Outputs**

- `assets` (list): The assets found
- `count` (number): How many were returned

**Example output**

```json
{
  "assets": [
    {
      "archive": false,
      "brandId": "8F7A1B4F-1D28-4F32-902E2501A6433462",
      "copyright": "Acme Inc.",
      "dateCreated": "2026-10-15T09:00:00Z",
      "dateModified": "2026-10-16T11:30:00Z",
      "datePublished": "2026-10-15T09:00:00Z",
      "description": "Hero image for the spring campaign.",
      "extension": [
        "jpg"
      ],
      "fileSize": 482113,
      "height": 1600,
      "id": "8EC04DC8-F7FE-4D2D-BE2F2789A632393D",
      "idHash": "55261de977ff5163",
      "isPublic": false,
      "limited": false,
      "name": "Spring campaign hero image",
      "orientation": "landscape",
      "original": "",
      "propertyOptions": [
        "551CB615-965F-4643-A2A7A4974AA0B128"
      ],
      "tags": [
        "spring",
        "hero"
      ],
      "thumbnails": {
        "mini": "https://acme.bynder.com/m/55261de977ff5163/mini-hero.jpg",
        "thul": "https://acme.bynder.com/m/55261de977ff5163/thul-hero.jpg",
        "webimage": "https://acme.bynder.com/m/55261de977ff5163/webimage-hero.jpg"
      },
      "transformBaseUrl": "https://acme.bynder.com/transform/8ec04dc8/hero",
      "type": "image",
      "userCreated": "Jo Bloggs",
      "videoPreviewURLs": [],
      "watermarked": false,
      "width": 2400
    }
  ],
  "count": 1
}
```

### Get asset

Get one asset with its details, tags and preview links.

**Inputs**

- Asset (`asset_id`, text, required): The asset. Pick one of the most recently changed, or give its id from an earlier step.
- Include versions (`include_versions`, true/false): On to include each of its files and versions.
- Include views and downloads (`include_stats`, true/false): On to include how often it was viewed and downloaded. Needs the statistics permission.

**Outputs**

- `asset` (object): The asset

**Example output**

```json
{
  "asset": {
    "archive": false,
    "brandId": "8F7A1B4F-1D28-4F32-902E2501A6433462",
    "copyright": "Acme Inc.",
    "dateCreated": "2026-10-15T09:00:00Z",
    "dateModified": "2026-10-16T11:30:00Z",
    "datePublished": "2026-10-15T09:00:00Z",
    "description": "Hero image for the spring campaign.",
    "extension": [
      "jpg"
    ],
    "fileSize": 482113,
    "height": 1600,
    "id": "8EC04DC8-F7FE-4D2D-BE2F2789A632393D",
    "idHash": "55261de977ff5163",
    "isPublic": false,
    "limited": false,
    "name": "Spring campaign hero image",
    "orientation": "landscape",
    "original": "",
    "propertyOptions": [
      "551CB615-965F-4643-A2A7A4974AA0B128"
    ],
    "tags": [
      "spring",
      "hero"
    ],
    "thumbnails": {
      "mini": "https://acme.bynder.com/m/55261de977ff5163/mini-hero.jpg",
      "thul": "https://acme.bynder.com/m/55261de977ff5163/thul-hero.jpg",
      "webimage": "https://acme.bynder.com/m/55261de977ff5163/webimage-hero.jpg"
    },
    "transformBaseUrl": "https://acme.bynder.com/transform/8ec04dc8/hero",
    "type": "image",
    "userCreated": "Jo Bloggs",
    "videoPreviewURLs": [],
    "watermarked": false,
    "width": 2400
  }
}
```

### Get asset download link

Get a short-lived link to download an asset's original file.

**Inputs**

- Asset (`asset_id`, text, required): The asset. Pick one of the most recently changed, or give its id from an earlier step.

**Outputs**

- `asset_id` (text): The asset's id
- `url` (text): A link to the original file; it stops working after a while

**Example output**

```json
{
  "asset_id": "8EC04DC8-F7FE-4D2D-BE2F2789A632393D",
  "url": "https://bynder-public.s3.amazonaws.com/acme/hero.jpg?X-Amz-Expires=900"
}
```

### Get collection

Get one collection's name, description, link and views.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id from an earlier step.

**Outputs**

- `collection` (object): The collection

**Example output**

```json
{
  "collection": {
    "dateCreated": "March, 01 2026 10:49:12 +0000",
    "description": "Assets for the spring campaign.",
    "id": "00B627BB-8054-44C0-A343FCF40BC790CD",
    "link": "https://acme.bynder.com/collections/view/00B627BB/",
    "name": "Spring campaign",
    "thumbnail": "https://acme.bynder.com/collections/spring/thumb.jpg",
    "user": {
      "id": "48817BA7-2FC3-4A43-918761514D322C15",
      "name": "Jo Bloggs"
    },
    "views": 2
  }
}
```

### Get current user

Get the Bynder user the connection acts as: the OAuth app's assigned user.

**Inputs**: None.

**Outputs**

- `user` (object): The user the connection acts as

**Example output**

```json
{
  "user": {
    "active": true,
    "companyName": "",
    "department": "",
    "email": "integrations@acme.com",
    "firstname": "Lodol",
    "id": "48817BA7-2FC3-4A43-918761514D322C15",
    "job": "",
    "language": "en_US",
    "lastLogin": "",
    "lastname": "Integration",
    "profileId": "2C5E8A1B-3D4F-4A6B-9C8D7E6F5A4B3C2D",
    "timeZone": "Europe/Amsterdam",
    "username": "lodol.integration"
  }
}
```

### List assets in collection

List the ids of the assets in a collection. 'Find assets' with the collection gives their details.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id from an earlier step.

**Outputs**

- `asset_ids` (list): The assets' ids
- `collection_id` (text): The collection's id
- `count` (number): How many were returned

**Example output**

```json
{
  "asset_ids": [
    "8EC04DC8-F7FE-4D2D-BE2F2789A632393D"
  ],
  "collection_id": "00B627BB-8054-44C0-A343FCF40BC790CD",
  "count": 1
}
```

### List brands

List the portal's brands, each with its sub-brands.

**Inputs**: None.

**Outputs**

- `brands` (list): The brands
- `count` (number): How many were returned

**Example output**

```json
{
  "brands": [
    {
      "description": "Acme's main brand",
      "id": "8F7A1B4F-1D28-4F32-902E2501A6433462",
      "image": "https://acme.bynder.com/brands/acme.png",
      "name": "Acme",
      "subBrands": [
        {
          "description": "",
          "id": "1D2E3F4A-5B6C-4D7E-8F9A0B1C2D3E4F5A",
          "image": "",
          "name": "Acme Outdoor"
        }
      ]
    }
  ],
  "count": 1
}
```

### List collections

List the collections the assigned user can see.

**Inputs**

- Keyword (`keyword`, text): Only those whose name matches these words.
- Order (`order_by`, text): How to sort them. One of: `dateCreated desc` (Newest first), `dateCreated asc` (Oldest first), `name asc` (Name, A to Z), `name desc` (Name, Z to A).
- Public only (`public_only`, true/false): On for only public collections.
- Page size (`limit`, number): How many to return, 1 to 1000. Bynder's default is 50. From 1 to 1000.
- Page (`page`, number): Which page of results, from 1. Leave empty for the first. At least 1.

**Outputs**

- `collections` (list): The collections
- `count` (number): How many were returned

**Example output**

```json
{
  "collections": [
    {
      "collectionCount": 2,
      "cover": {
        "large": "https://acme.bynder.com/collections/spring/large.jpg",
        "thumbnail": "https://acme.bynder.com/collections/spring/thumb.jpg"
      },
      "dateCreated": "March, 01 2026 10:49:12 +0000",
      "dateModified": "March, 08 2026 14:17:37 +0000",
      "description": "Assets for the spring campaign.",
      "id": "00B627BB-8054-44C0-A343FCF40BC790CD",
      "isPublic": false,
      "name": "Spring campaign",
      "user": {
        "id": "48817BA7-2FC3-4A43-918761514D322C15",
        "name": "Jo Bloggs"
      },
      "userId": "48817BA7-2FC3-4A43-918761514D322C15"
    }
  ],
  "count": 1
}
```

### List metaproperties

List the portal's metaproperties (its metadata fields, such as Country or Campaign), with their options if asked.

**Inputs**

- Include options (`include_options`, true/false): On to include each metaproperty's options. Slower on a large portal.

**Outputs**

- `count` (number): How many were returned
- `metaproperties` (list): The metaproperties

**Example output**

```json
{
  "count": 1,
  "metaproperties": [
    {
      "id": "C53BC6FD-21A0-4DF1-AE80F0A329D7AB12",
      "isEditable": true,
      "isFilterable": true,
      "isMultiselect": true,
      "isRequired": false,
      "label": "Country",
      "name": "country",
      "options": [
        {
          "active": 1,
          "date": "2026-02-15T14:54:58+00:00",
          "displayLabel": "France",
          "id": "551CB615-965F-4643-A2A7A4974AA0B128",
          "label": "France",
          "name": "france"
        }
      ],
      "type": "select2",
      "zindex": 1
    }
  ]
}
```

### List metaproperty options

List the options of one metaproperty, such as each country of Country.

**Inputs**

- Metaproperty (`metaproperty_id`, text, required): The metaproperty. Pick one, or give its id.
- Option name (`name`, text): Only the option with this name.
- Page size (`limit`, number): How many to return, 1 to 1000. Bynder's default is 50. From 1 to 1000.
- Page (`page`, number): Which page of results, from 1. Leave empty for the first. At least 1.

**Outputs**

- `count` (number): How many were returned
- `metaproperty_id` (text): The metaproperty's id
- `options` (list): Its options

**Example output**

```json
{
  "count": 1,
  "metaproperty_id": "C53BC6FD-21A0-4DF1-AE80F0A329D7AB12",
  "options": [
    {
      "active": 1,
      "date": "2026-02-15T14:54:58+00:00",
      "displayLabel": "France",
      "id": "551CB615-965F-4643-A2A7A4974AA0B128",
      "label": "France",
      "name": "france"
    }
  ]
}
```

### List recently removed assets

List the assets removed in the last 30 days, most recent first, with who removed them.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 1000. Bynder's default is 50. From 1 to 1000.
- Page (`page`, number): Which page of results, from 1. Leave empty for the first. At least 1.

**Outputs**

- `assets` (list): The removed assets
- `count` (number): How many were returned

**Example output**

```json
{
  "assets": [
    {
      "dateCreated": "2025-04-01T10:00:00Z",
      "dateRemoved": "2026-10-20T08:15:00Z",
      "id": "8EC04DC8-F7FE-4D2D-BE2F2789A632393D",
      "name": "Old banner",
      "userId": "48817BA7-2FC3-4A43-918761514D322C15",
      "username": "jo.bloggs"
    }
  ],
  "count": 1
}
```

### List tags

List the portal's tags with how many assets have each.

**Inputs**

- Keyword (`keyword`, text): Only tags containing this text.
- Order (`order_by`, text): How to sort them. One of: `mediaCount desc` (Most used first), `tag asc` (A to Z), `tag desc` (Z to A).
- Used at least (`min_count`, number): Only tags on at least this many assets. At least 0.
- Page size (`limit`, number): How many to return, 1 to 1000. Bynder's default is 50. From 1 to 1000.
- Page (`page`, number): Which page of results, from 1. Leave empty for the first. At least 1.

**Outputs**

- `count` (number): How many were returned
- `tags` (list): The tags

**Example output**

```json
{
  "count": 1,
  "tags": [
    {
      "id": "4C2B1A3D-5E6F-4A7B-8C9D0E1F2A3B4C5D",
      "mediaCount": 12,
      "tag": "spring"
    }
  ]
}
```

### List users

List the portal's users with their emails and groups. The assigned user needs permission to manage users.

**Inputs**

- Include inactive users (`include_inactive`, true/false): On to include users whose accounts are turned off.
- Page size (`limit`, number): How many to return, 1 to 1000. Bynder's default is 50. From 1 to 1000.
- Page (`page`, number): Which page of results, from 1. Leave empty for the first. At least 1.

**Outputs**

- `count` (number): How many were returned
- `users` (list): The users

**Example output**

```json
{
  "count": 1,
  "users": [
    {
      "active": 1,
      "email": "jo@acme.com",
      "groups": [
        {
          "id": "A1B2C3D4-E5F6-4A7B-8C9D0E1F2A3B4C5D",
          "name": "Marketing"
        }
      ],
      "id": "48817BA7-2FC3-4A43-918761514D322C15",
      "isSSOOnly": false,
      "name": "Jo Bloggs",
      "profileId": "",
      "username": "jo.bloggs"
    }
  ]
}
```

### Remove assets from collection

Take assets out of a collection. They stay in the portal.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id from an earlier step.
- Assets (`asset_ids`, list, required): The assets. Pick from the most recently changed, or give ids from an earlier step (up to 500).

**Outputs**

- `asset_ids` (list): The assets' ids
- `collection_id` (text): The collection's id
- `count` (number): How many assets were sent

**Example output**

```json
{
  "asset_ids": [
    "8EC04DC8-F7FE-4D2D-BE2F2789A632393D"
  ],
  "collection_id": "00B627BB-8054-44C0-A343FCF40BC790CD",
  "count": 1
}
```

### Remove tag from assets

Remove one tag from several assets.

**Inputs**

- Tag (`tag_id`, text, required): The tag. Pick one, or give its id from 'List tags'. To use a new tag, set it on an asset with 'Update asset' first.
- Assets (`asset_ids`, list, required): The assets. Pick from the most recently changed, or give ids from an earlier step (up to 500).

**Outputs**

- `asset_ids` (list): The assets' ids
- `count` (number): How many assets were sent
- `tag_id` (text): The tag's id

**Example output**

```json
{
  "asset_ids": [
    "8EC04DC8-F7FE-4D2D-BE2F2789A632393D"
  ],
  "count": 1,
  "tag_id": "4C2B1A3D-5E6F-4A7B-8C9D0E1F2A3B4C5D"
}
```

### Share collection

Share a collection with people by email, to view or to edit, for a while or for good.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id from an earlier step.
- Recipients (`recipients`, list, required): Who to share it with: pick portal users, or type email addresses.
- Permission (`permission`, text): Whether they can only view it or also edit it. Defaults to view. One of: `view` (Can view), `edit` (Can edit).
- Email them (`send_email`, true/false): On to have Bynder email each recipient a link.
- Message (`message`, text): A message for the email Bynder sends.
- Sign-in required (`login_required`, true/false): On if recipients must sign in to the portal to open it.
- Shared from (`starts_at`, date and time): When the share starts.
- Shared until (`ends_at`, date and time): When the share ends.

**Outputs**

- `collection_id` (text): The collection's id
- `message` (text): Bynder's answer, such as Accepted
- `permission` (text): view or edit
- `recipients` (list): Who it was shared with

**Example output**

```json
{
  "collection_id": "00B627BB-8054-44C0-A343FCF40BC790CD",
  "message": "Collection shared",
  "permission": "view",
  "recipients": [
    "jo@acme.com"
  ]
}
```

### Update asset

Change an asset's name, description, copyright, tags, archive state, dates or metaproperties. Fields left empty keep their values.

**Inputs**

- Asset (`asset_id`, text, required): The asset. Pick one of the most recently changed, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.
- Copyright (`copyright`, text): New copyright information. Leave empty to keep it.
- Tags (`tags`, list): The asset's tags. These replace all its tags; leave empty to keep them.
- Archived (`archived`, true/false): On to archive the asset, off to bring it back.
- Limited usage (`limited`, true/false): On to mark it limited usage, off to clear that.
- Publication date (`date_published`, date and time): A new publication date.
- Archive on (`archive_date`, date and time): When Bynder should archive the asset by itself.
- Metaproperties (`metaproperties`, object): Values for the portal's metaproperties, such as Country or Campaign. Fill in only the ones to set; for one that takes several options, separate them with commas.

**Outputs**

- `asset_id` (text): The asset's id
- `changed` (list): The fields sent, as Bynder names them
- `message` (text): Bynder's answer, such as Accepted
- `updated` (true/false): Always true once Bynder accepted the change

**Example output**

```json
{
  "asset_id": "8EC04DC8-F7FE-4D2D-BE2F2789A632393D",
  "changed": [
    "description",
    "name",
    "tags"
  ],
  "message": "Accepted",
  "updated": true
}
```

### Update collection

Rename a collection or change its description.

**Inputs**

- Collection (`collection_id`, text, required): The collection. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.

**Outputs**

- `collection_id` (text): The collection's id
- `message` (text): Bynder's answer, such as Accepted
- `updated` (true/false): Always true once Bynder accepted the change

**Example output**

```json
{
  "collection_id": "00B627BB-8054-44C0-A343FCF40BC790CD",
  "message": "Collection modified",
  "updated": true
}
```

### Upload asset

Upload a file to Bynder as a new asset in a brand, with its name, description, tags and metaproperties.

**Inputs**

- File (`file`, text, required): The file: upload one, pick one an earlier step made, or give a link to a file anyone can open. Up to 200 MB.
- File name (`file_name`, text): The file's name with its extension, such as banner.jpg. Leave empty to keep the file's own name.
- Brand (`brand_id`, text, required): The brand the asset belongs to.
- Name (`name`, text): The asset's name. Leave empty to use the file's name.
- Description (`description`, text): The asset's description.
- Tags (`tags`, list): Tags to give the asset.
- Copyright (`copyright`, text): Copyright information for the asset.
- Metaproperties (`metaproperties`, object): Values for the portal's metaproperties, such as Country or Campaign. Fill in only the ones to set; for one that takes several options, separate them with commas.

**Outputs**

- `asset_id` (text): The id of the asset the file was saved to
- `batch_id` (text): The id of Bynder's upload batch
- `file_name` (text): The name the file was saved under
- `media_items` (list): The files Bynder made from it
- `size_bytes` (number): The file's size in bytes

**Example output**

```json
{
  "asset_id": "8EC04DC8-F7FE-4D2D-BE2F2789A632393D",
  "batch_id": "1A2B3C4D-5E6F-4A7B-8C9D0E1F2A3B4C5D",
  "file_name": "hero.jpg",
  "media_items": [
    {
      "destination": "https://acme.bynder.com/m/55261de977ff5163/hero.jpg",
      "original": "final/8EC04DC8-F7FE-4D2D-BE2F2789A632393D/hero.jpg"
    }
  ],
  "size_bytes": 482113
}
```

### Upload new version of asset

Upload a file as the newest version of an asset, keeping its details.

**Inputs**

- Asset (`asset_id`, text, required): The asset. Pick one of the most recently changed, or give its id from an earlier step.
- File (`file`, text, required): The file: upload one, pick one an earlier step made, or give a link to a file anyone can open. Up to 200 MB.
- File name (`file_name`, text): The file's name with its extension, such as banner.jpg. Leave empty to keep the file's own name.

**Outputs**

- `asset_id` (text): The id of the asset the file was saved to
- `batch_id` (text): The id of Bynder's upload batch
- `file_name` (text): The name the file was saved under
- `media_items` (list): The files Bynder made from it
- `size_bytes` (number): The file's size in bytes

**Example output**

```json
{
  "asset_id": "8EC04DC8-F7FE-4D2D-BE2F2789A632393D",
  "batch_id": "1A2B3C4D-5E6F-4A7B-8C9D0E1F2A3B4C5D",
  "file_name": "hero-v2.jpg",
  "media_items": [],
  "size_bytes": 501337
}
```
