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

# bynder-assets

> Bynder Assets - Search, manage, and organize digital assets including collections, tags, downloads, and usage tracking

**Server path:** `/bynder-assets` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                          | Description                                    |
| --------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| [`bynder_assets_add_assets_to_collection`](#bynder_assets_add_assets_to_collection)           | Add assets to a collection                     |
| [`bynder_assets_add_tag_to_assets`](#bynder_assets_add_tag_to_assets)                         | Add tag to assets                              |
| [`bynder_assets_create_asset_usage`](#bynder_assets_create_asset_usage)                       | Create asset usage record                      |
| [`bynder_assets_create_collection`](#bynder_assets_create_collection)                         | Create a collection                            |
| [`bynder_assets_delete_asset`](#bynder_assets_delete_asset)                                   | Delete an asset                                |
| [`bynder_assets_delete_asset_usage`](#bynder_assets_delete_asset_usage)                       | Delete asset usage record                      |
| [`bynder_assets_delete_collection`](#bynder_assets_delete_collection)                         | Delete a collection                            |
| [`bynder_assets_get_asset`](#bynder_assets_get_asset)                                         | Retrieve a specific asset                      |
| [`bynder_assets_get_asset_download_url`](#bynder_assets_get_asset_download_url)               | Retrieve asset download location               |
| [`bynder_assets_get_asset_item_download_url`](#bynder_assets_get_asset_item_download_url)     | Retrieve specific asset item download location |
| [`bynder_assets_get_asset_public_links`](#bynder_assets_get_asset_public_links)               | Get public links for an asset                  |
| [`bynder_assets_get_collection`](#bynder_assets_get_collection)                               | Retrieve a specific collection                 |
| [`bynder_assets_list_asset_usage`](#bynder_assets_list_asset_usage)                           | Retrieve asset usage                           |
| [`bynder_assets_list_assets`](#bynder_assets_list_assets)                                     | Retrieve assets                                |
| [`bynder_assets_list_collection_assets`](#bynder_assets_list_collection_assets)               | Retrieve assets of a collection                |
| [`bynder_assets_list_collections`](#bynder_assets_list_collections)                           | Retrieve collections                           |
| [`bynder_assets_list_tags`](#bynder_assets_list_tags)                                         | Retrieve tags                                  |
| [`bynder_assets_list_trashed_assets`](#bynder_assets_list_trashed_assets)                     | Retrieve recently removed assets               |
| [`bynder_assets_modify_asset`](#bynder_assets_modify_asset)                                   | Modify an asset                                |
| [`bynder_assets_modify_collection`](#bynder_assets_modify_collection)                         | Modify a collection                            |
| [`bynder_assets_remove_assets_from_collection`](#bynder_assets_remove_assets_from_collection) | Remove assets from a collection                |
| [`bynder_assets_remove_tag_from_assets`](#bynder_assets_remove_tag_from_assets)               | Remove tag from assets                         |
| [`bynder_assets_search_similar_assets`](#bynder_assets_search_similar_assets)                 | Search for similar assets                      |
| [`bynder_assets_share_collection`](#bynder_assets_share_collection)                           | Share a collection                             |

***

## bynder\_assets\_add\_assets\_to\_collection

Add assets to a collection

**Parameters:**

| Parameter | Type   | Required | Default | Description                                      |
| --------- | ------ | -------- | ------- | ------------------------------------------------ |
| `id`      | string | Yes      | —       | Collection identifier                            |
| `data`    | string | Yes      | —       | JSON array of asset IDs to add to the collection |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Collection identifier"
      },
      "data": {
        "type": "string",
        "description": "JSON array of asset IDs to add to the collection"
      }
    },
    "required": [
      "PCID",
      "id",
      "data"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_add\_tag\_to\_assets

Add tag to assets

**Parameters:**

| Parameter | Type   | Required | Default | Description                    |
| --------- | ------ | -------- | ------- | ------------------------------ |
| `id`      | string | Yes      | —       | Tag identifier                 |
| `data`    | string | Yes      | —       | JSON array of asset IDs to tag |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Tag identifier"
      },
      "data": {
        "type": "string",
        "description": "JSON array of asset IDs to tag"
      }
    },
    "required": [
      "PCID",
      "id",
      "data"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_create\_asset\_usage

Create asset usage record

**Parameters:**

| Parameter        | Type   | Required | Default | Description                            |
| ---------------- | ------ | -------- | ------- | -------------------------------------- |
| `additional`     | string | No       | —       | Additional information about the usage |
| `asset_id`       | string | Yes      | —       | Asset identifier                       |
| `integration_id` | string | Yes      | —       | Integration identifier                 |
| `uri`            | string | Yes      | —       | URI where the asset is used            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "additional": {
        "type": "string",
        "description": "Additional information about the usage"
      },
      "asset_id": {
        "type": "string",
        "description": "Asset identifier"
      },
      "integration_id": {
        "type": "string",
        "description": "Integration identifier"
      },
      "uri": {
        "type": "string",
        "description": "URI where the asset is used"
      }
    },
    "required": [
      "PCID",
      "asset_id",
      "integration_id",
      "uri"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_create\_collection

Create a collection

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                   |
| ------------- | ------- | -------- | ------- | --------------------------------------------- |
| `description` | string  | No       | —       | Description of the collection                 |
| `isPublic`    | boolean | No       | —       | Whether the collection is publicly accessible |
| `name`        | string  | Yes      | —       | Name of the collection                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "description": {
        "type": "string",
        "description": "Description of the collection"
      },
      "isPublic": {
        "type": "boolean",
        "description": "Whether the collection is publicly accessible"
      },
      "name": {
        "type": "string",
        "description": "Name of the collection"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_delete\_asset

Delete an asset

**Parameters:**

| Parameter | Type   | Required | Default | Description      |
| --------- | ------ | -------- | ------- | ---------------- |
| `id`      | string | Yes      | —       | Asset identifier |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Asset identifier"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_delete\_asset\_usage

Delete asset usage record

**Parameters:**

| Parameter        | Type   | Required | Default | Description                |
| ---------------- | ------ | -------- | ------- | -------------------------- |
| `asset_id`       | string | Yes      | —       | Asset identifier           |
| `integration_id` | string | Yes      | —       | Integration identifier     |
| `uri`            | string | Yes      | —       | URI of the usage to delete |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "asset_id": {
        "type": "string",
        "description": "Asset identifier"
      },
      "integration_id": {
        "type": "string",
        "description": "Integration identifier"
      },
      "uri": {
        "type": "string",
        "description": "URI of the usage to delete"
      }
    },
    "required": [
      "PCID",
      "asset_id",
      "integration_id",
      "uri"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_delete\_collection

Delete a collection

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | Collection identifier |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Collection identifier"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_get\_asset

Retrieve a specific asset

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                                  |
| ---------- | ------- | -------- | ------- | ---------------------------------------------------------------------------- |
| `id`       | string  | Yes      | —       | Asset identifier                                                             |
| `versions` | boolean | No       | —       | Include information about the different asset media items including versions |
| `stats`    | boolean | No       | —       | Include views and downloads statistics information                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Asset identifier"
      },
      "versions": {
        "type": "boolean",
        "description": "Include information about the different asset media items including versions"
      },
      "stats": {
        "type": "boolean",
        "description": "Include views and downloads statistics information"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_get\_asset\_download\_url

Retrieve asset download location

**Parameters:**

| Parameter | Type   | Required | Default | Description      |
| --------- | ------ | -------- | ------- | ---------------- |
| `id`      | string | Yes      | —       | Asset identifier |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Asset identifier"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_get\_asset\_item\_download\_url

Retrieve specific asset item download location

**Parameters:**

| Parameter | Type   | Required | Default | Description                                       |
| --------- | ------ | -------- | ------- | ------------------------------------------------- |
| `id`      | string | Yes      | —       | Asset identifier                                  |
| `itemId`  | string | Yes      | —       | Media item identifier for the specific derivative |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Asset identifier"
      },
      "itemId": {
        "type": "string",
        "description": "Media item identifier for the specific derivative"
      }
    },
    "required": [
      "PCID",
      "id",
      "itemId"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_get\_asset\_public\_links

Get public links for an asset

**Parameters:**

| Parameter  | Type   | Required | Default | Description                                                       |
| ---------- | ------ | -------- | ------- | ----------------------------------------------------------------- |
| `asset_id` | string | Yes      | —       | UUID of the asset to retrieve adaptive streaming public links for |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "asset_id": {
        "type": "string",
        "description": "UUID of the asset to retrieve adaptive streaming public links for"
      }
    },
    "required": [
      "PCID",
      "asset_id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_get\_collection

Retrieve a specific collection

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | Collection identifier |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Collection identifier"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_list\_asset\_usage

Retrieve asset usage

**Parameters:**

| Parameter  | Type   | Required | Default | Description                |
| ---------- | ------ | -------- | ------- | -------------------------- |
| `asset_id` | string | No       | —       | Filter by asset identifier |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "asset_id": {
        "type": "string",
        "description": "Filter by asset identifier"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_list\_assets

Retrieve assets

**Parameters:**

| Parameter              | Type    | Required | Default | Description                                                                         |
| ---------------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------- |
| `keyword`              | string  | No       | —       | Search on filenames, tags, extensions, collection names, and other asset properties |
| `type`                 | string  | No       | —       | Filter by asset type: image, document, audio, video, or 3d                          |
| `brandId`              | string  | No       | —       | Filter by brand identifier                                                          |
| `subBrandId`           | string  | No       | —       | Filter by sub-brand identifier                                                      |
| `categoryId`           | string  | No       | —       | Filter by category identifier                                                       |
| `id`                   | string  | No       | —       | Asset identifier to retrieve a single asset from list endpoint                      |
| `collectionId`         | string  | No       | —       | Filter by collection identifier                                                     |
| `propertyOptionId`     | string  | No       | —       | Comma-separated list of metaproperty option IDs to filter by                        |
| `ids`                  | string  | No       | —       | Comma-separated list of asset identifiers to retrieve specific assets               |
| `tags`                 | string  | No       | —       | Comma-separated tag values to filter by                                             |
| `orientation`          | string  | No       | —       | Filter by asset orientation                                                         |
| `limited`              | boolean | No       | —       | Filter for assets marked as limited usage                                           |
| `archive`              | boolean | No       | —       | Filter for archived assets                                                          |
| `isPublic`             | boolean | No       | —       | Filter for publicly marked assets                                                   |
| `dateCreated`          | string  | No       | —       | Filter assets created after this ISO8601 date                                       |
| `dateCreatedTo`        | string  | No       | —       | End date range for dateCreated filter                                               |
| `dateCreatedOn`        | string  | No       | —       | Filter assets created on this specific ISO8601 date                                 |
| `dateModified`         | string  | No       | —       | Filter assets modified after this ISO8601 date                                      |
| `dateModifiedTo`       | string  | No       | —       | End date range for dateModified filter                                              |
| `dateModifiedOn`       | string  | No       | —       | Filter assets modified on this specific ISO8601 date                                |
| `orderBy`              | string  | No       | —       | Sort results, e.g. 'dateCreated desc', 'name asc'                                   |
| `limit`                | integer | No       | —       | Maximum results per page (default 50, max 1000)                                     |
| `page`                 | integer | No       | —       | Page number for pagination (default 1)                                              |
| `count`                | boolean | No       | —       | Include count results in response                                                   |
| `total`                | boolean | No       | —       | Include total count of matching results                                             |
| `includeMediaItems`    | boolean | No       | —       | Include all media item derivatives per asset                                        |
| `includeVersionNumber` | boolean | No       | —       | Include the active version number in each asset response                            |
| `cursor`               | string  | No       | —       | Cursor mark from X-Bynder-NextCursor response header for cursor-based pagination    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "keyword": {
        "type": "string",
        "description": "Search on filenames, tags, extensions, collection names, and other asset properties"
      },
      "type": {
        "type": "string",
        "description": "Filter by asset type: image, document, audio, video, or 3d",
        "enum": [
          "image",
          "document",
          "audio",
          "video",
          "3d"
        ]
      },
      "brandId": {
        "type": "string",
        "description": "Filter by brand identifier"
      },
      "subBrandId": {
        "type": "string",
        "description": "Filter by sub-brand identifier"
      },
      "categoryId": {
        "type": "string",
        "description": "Filter by category identifier"
      },
      "id": {
        "type": "string",
        "description": "Asset identifier to retrieve a single asset from list endpoint"
      },
      "collectionId": {
        "type": "string",
        "description": "Filter by collection identifier"
      },
      "propertyOptionId": {
        "type": "string",
        "description": "Comma-separated list of metaproperty option IDs to filter by"
      },
      "ids": {
        "type": "string",
        "description": "Comma-separated list of asset identifiers to retrieve specific assets"
      },
      "tags": {
        "type": "string",
        "description": "Comma-separated tag values to filter by"
      },
      "orientation": {
        "type": "string",
        "description": "Filter by asset orientation",
        "enum": [
          "square",
          "portrait",
          "landscape"
        ]
      },
      "limited": {
        "type": "boolean",
        "description": "Filter for assets marked as limited usage"
      },
      "archive": {
        "type": "boolean",
        "description": "Filter for archived assets"
      },
      "isPublic": {
        "type": "boolean",
        "description": "Filter for publicly marked assets"
      },
      "dateCreated": {
        "type": "string",
        "description": "Filter assets created after this ISO8601 date"
      },
      "dateCreatedTo": {
        "type": "string",
        "description": "End date range for dateCreated filter"
      },
      "dateCreatedOn": {
        "type": "string",
        "description": "Filter assets created on this specific ISO8601 date"
      },
      "dateModified": {
        "type": "string",
        "description": "Filter assets modified after this ISO8601 date"
      },
      "dateModifiedTo": {
        "type": "string",
        "description": "End date range for dateModified filter"
      },
      "dateModifiedOn": {
        "type": "string",
        "description": "Filter assets modified on this specific ISO8601 date"
      },
      "orderBy": {
        "type": "string",
        "description": "Sort results, e.g. 'dateCreated desc', 'name asc'"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum results per page (default 50, max 1000)"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination (default 1)"
      },
      "count": {
        "type": "boolean",
        "description": "Include count results in response"
      },
      "total": {
        "type": "boolean",
        "description": "Include total count of matching results"
      },
      "includeMediaItems": {
        "type": "boolean",
        "description": "Include all media item derivatives per asset"
      },
      "includeVersionNumber": {
        "type": "boolean",
        "description": "Include the active version number in each asset response"
      },
      "cursor": {
        "type": "string",
        "description": "Cursor mark from X-Bynder-NextCursor response header for cursor-based pagination"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_list\_collection\_assets

Retrieve assets of a collection

**Parameters:**

| Parameter | Type    | Required | Default | Description                |
| --------- | ------- | -------- | ------- | -------------------------- |
| `id`      | string  | Yes      | —       | Collection identifier      |
| `limit`   | integer | No       | —       | Maximum results per page   |
| `page`    | integer | No       | —       | Page number for pagination |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Collection identifier"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum results per page"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_list\_collections

Retrieve collections

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                     |
| ---------- | ------- | -------- | ------- | --------------------------------------------------------------- |
| `keyword`  | string  | No       | —       | Search collections by name or content                           |
| `ids`      | string  | No       | —       | Comma-separated collection IDs to retrieve specific collections |
| `isPublic` | boolean | No       | —       | Filter by public collections only                               |
| `orderBy`  | string  | No       | —       | Sort results, e.g. 'dateCreated desc', 'name asc'               |
| `limit`    | integer | No       | —       | Maximum results per page (default 50, max 1000)                 |
| `page`     | integer | No       | —       | Page number for pagination (default 1)                          |
| `count`    | boolean | No       | —       | Include total count in response                                 |
| `minCount` | integer | No       | —       | Return only collections with at least this many assets          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "keyword": {
        "type": "string",
        "description": "Search collections by name or content"
      },
      "ids": {
        "type": "string",
        "description": "Comma-separated collection IDs to retrieve specific collections"
      },
      "isPublic": {
        "type": "boolean",
        "description": "Filter by public collections only"
      },
      "orderBy": {
        "type": "string",
        "description": "Sort results, e.g. 'dateCreated desc', 'name asc'"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum results per page (default 50, max 1000)"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination (default 1)"
      },
      "count": {
        "type": "boolean",
        "description": "Include total count in response"
      },
      "minCount": {
        "type": "integer",
        "description": "Return only collections with at least this many assets"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_list\_tags

Retrieve tags

**Parameters:**

| Parameter | Type    | Required | Default | Description                |
| --------- | ------- | -------- | ------- | -------------------------- |
| `limit`   | integer | No       | —       | Maximum results per page   |
| `page`    | integer | No       | —       | Page number for pagination |
| `keyword` | string  | No       | —       | Search tags by keyword     |
| `orderBy` | string  | No       | —       | Sort order for results     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum results per page"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination"
      },
      "keyword": {
        "type": "string",
        "description": "Search tags by keyword"
      },
      "orderBy": {
        "type": "string",
        "description": "Sort order for results"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_list\_trashed\_assets

Retrieve recently removed assets

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                     |
| ------------- | ------- | -------- | ------- | ----------------------------------------------- |
| `limit`       | integer | No       | —       | Maximum number of results to return             |
| `page`        | integer | No       | —       | Offset page for paginated results               |
| `dateRemoved` | string  | No       | —       | Retrieve assets removed after this ISO8601 date |
| `field`       | string  | No       | —       | Field used to sort trash results                |
| `order`       | string  | No       | —       | Sort direction                                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results to return"
      },
      "page": {
        "type": "integer",
        "description": "Offset page for paginated results"
      },
      "dateRemoved": {
        "type": "string",
        "description": "Retrieve assets removed after this ISO8601 date"
      },
      "field": {
        "type": "string",
        "description": "Field used to sort trash results",
        "enum": [
          "media.dateCreated",
          "media.dateRemoved",
          "media.name",
          "media.username"
        ]
      },
      "order": {
        "type": "string",
        "description": "Sort direction",
        "enum": [
          "asc",
          "desc"
        ]
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_modify\_asset

Modify an asset

**Parameters:**

| Parameter       | Type    | Required | Default | Description                                                    |
| --------------- | ------- | -------- | ------- | -------------------------------------------------------------- |
| `id`            | string  | Yes      | —       | Asset identifier                                               |
| `archive`       | boolean | No       | —       | Set the archived state of the asset                            |
| `archiveDate`   | string  | No       | —       | Archive datetime in ISO8601 format                             |
| `brandId`       | string  | No       | —       | Brand identifier to assign the asset to                        |
| `copyright`     | string  | No       | —       | Copyright information                                          |
| `datePublished` | string  | No       | —       | Publication datetime in ISO8601 format                         |
| `description`   | string  | No       | —       | Asset description                                              |
| `isPublic`      | boolean | No       | —       | Set the public state (WARNING - irreversible once set to true) |
| `limited`       | boolean | No       | —       | Set the limited usage state of the asset                       |
| `limitedDate`   | string  | No       | —       | Limited usage end datetime in ISO8601 format                   |
| `metaproperty`  | object  | No       | —       | Dictionary with metaproperty option values to set on the asset |
| `name`          | string  | No       | —       | Name of the asset                                              |
| `tags`          | string  | No       | —       | Comma-separated tags (overwrites current tags list)            |
| `watermarkDate` | string  | No       | —       | Watermark datetime in ISO8601 format                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Asset identifier"
      },
      "archive": {
        "type": "boolean",
        "description": "Set the archived state of the asset"
      },
      "archiveDate": {
        "type": "string",
        "description": "Archive datetime in ISO8601 format"
      },
      "brandId": {
        "type": "string",
        "description": "Brand identifier to assign the asset to"
      },
      "copyright": {
        "type": "string",
        "description": "Copyright information"
      },
      "datePublished": {
        "type": "string",
        "description": "Publication datetime in ISO8601 format"
      },
      "description": {
        "type": "string",
        "description": "Asset description"
      },
      "isPublic": {
        "type": "boolean",
        "description": "Set the public state (WARNING - irreversible once set to true)"
      },
      "limited": {
        "type": "boolean",
        "description": "Set the limited usage state of the asset"
      },
      "limitedDate": {
        "type": "string",
        "description": "Limited usage end datetime in ISO8601 format"
      },
      "metaproperty": {
        "type": "object",
        "description": "Dictionary with metaproperty option values to set on the asset"
      },
      "name": {
        "type": "string",
        "description": "Name of the asset"
      },
      "tags": {
        "type": "string",
        "description": "Comma-separated tags (overwrites current tags list)"
      },
      "watermarkDate": {
        "type": "string",
        "description": "Watermark datetime in ISO8601 format"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_modify\_collection

Modify a collection

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                   |
| ------------- | ------- | -------- | ------- | --------------------------------------------- |
| `id`          | string  | Yes      | —       | Collection identifier                         |
| `description` | string  | No       | —       | Updated description of the collection         |
| `isPublic`    | boolean | No       | —       | Whether the collection is publicly accessible |
| `name`        | string  | No       | —       | Updated name of the collection                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Collection identifier"
      },
      "description": {
        "type": "string",
        "description": "Updated description of the collection"
      },
      "isPublic": {
        "type": "boolean",
        "description": "Whether the collection is publicly accessible"
      },
      "name": {
        "type": "string",
        "description": "Updated name of the collection"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_remove\_assets\_from\_collection

Remove assets from a collection

**Parameters:**

| Parameter   | Type   | Required | Default | Description                                             |
| ----------- | ------ | -------- | ------- | ------------------------------------------------------- |
| `id`        | string | Yes      | —       | Collection identifier                                   |
| `deleteIds` | string | Yes      | —       | Comma-separated asset IDs to remove from the collection |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Collection identifier"
      },
      "deleteIds": {
        "type": "string",
        "description": "Comma-separated asset IDs to remove from the collection"
      }
    },
    "required": [
      "PCID",
      "id",
      "deleteIds"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_remove\_tag\_from\_assets

Remove tag from assets

**Parameters:**

| Parameter   | Type   | Required | Default | Description                                      |
| ----------- | ------ | -------- | ------- | ------------------------------------------------ |
| `id`        | string | Yes      | —       | Tag identifier                                   |
| `deleteIds` | string | Yes      | —       | Comma-separated asset IDs to remove the tag from |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Tag identifier"
      },
      "deleteIds": {
        "type": "string",
        "description": "Comma-separated asset IDs to remove the tag from"
      }
    },
    "required": [
      "PCID",
      "id",
      "deleteIds"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_search\_similar\_assets

Search for similar assets

**Parameters:**

| Parameter   | Type      | Required | Default | Description                                                                            |
| ----------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------- |
| `assetIds`  | string\[] | No       | —       | List of asset IDs to search similar assets for (provide one search parameter set only) |
| `imageData` | string    | No       | —       | Base64-encoded image data to use for similarity search                                 |
| `imageUrl`  | string    | No       | —       | Public URL of an image to use for similarity search                                    |
| `textQuery` | string    | No       | —       | Text query describing the desired image                                                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "assetIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of asset IDs to search similar assets for (provide one search parameter set only)"
      },
      "imageData": {
        "type": "string",
        "description": "Base64-encoded image data to use for similarity search"
      },
      "imageUrl": {
        "type": "string",
        "description": "Public URL of an image to use for similarity search"
      },
      "textQuery": {
        "type": "string",
        "description": "Text query describing the desired image"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## bynder\_assets\_share\_collection

Share a collection

**Parameters:**

| Parameter           | Type    | Required | Default | Description                                               |
| ------------------- | ------- | -------- | ------- | --------------------------------------------------------- |
| `id`                | string  | Yes      | —       | Collection identifier                                     |
| `collectionOptions` | string  | No       | —       | Sharing options                                           |
| `loginRequired`     | boolean | No       | —       | Whether login is required to access the shared collection |
| `recipients`        | string  | Yes      | —       | Comma-separated email addresses to share with             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Collection identifier"
      },
      "collectionOptions": {
        "type": "string",
        "description": "Sharing options"
      },
      "loginRequired": {
        "type": "boolean",
        "description": "Whether login is required to access the shared collection"
      },
      "recipients": {
        "type": "string",
        "description": "Comma-separated email addresses to share with"
      }
    },
    "required": [
      "PCID",
      "id",
      "recipients"
    ]
  }
  ```
</Expandable>
