GET /asset/v1/content/assets
Get several assets by filter.
Get an asset collection by simple $filter parameters.
Name | Type | Description |
---|---|---|
$page | number | Page number to return from the paged results. Start with 1 and continue until you get zero results. Typically provided along with the $pagesize parameter. |
$pagesize | number | Number of results per page to return. Typically provided along with the $page parameter. |
$orderBy | string | Determines which asset property to use for sorting, and also determines the direction in which to sort the data. If you don't provide the $orderBy parameter, the results are sorted by asset ID in ascending order. |
$filter | string | Filter by an asset's property using a simple operator and value. |
$fields | string | Comma-delimited string of asset properties used to reduce the size of your results to only the properties you need. |
Status | Name | Type | Description |
---|---|---|---|
200 | A collection of assets | ||
CustomerKey | string | Reference to customer's private ID/name for the asset. | |
ContentType | string | The type that the Content attribute is in. | |
Data | object | Container for asset data. | |
AssetType | object | The type of the asset saved as a name/ID pair. | |
Version | number | The version of the asset. | |
Locked | boolean | Specifies whether the asset can be modified. | |
FileProperties | object | Stores the different properties that this asset refers to if it is a file type. | |
Name | string | Name of the asset, set by the client. 200 character maximum. | |
Description | string | Description of the asset, set by the client. | |
Category | object | ID of the category the asset belongs to. | |
Tags | array | List of tags associated with the asset. | |
Content | string | The actual content of the asset. | |
Design | string | Fallback for display when both Content and Supercontent are not provided. | |
SuperContent | string | Content that supersedes Content in terms of display. | |
CustomFields | object | Custom fields within an asset. | |
Views | object | Views within an asset. | |
Blocks | object | Blocks within the asset. | |
MinBlocks | number | Minimum number of blocks within an asset. | |
MaxBlocks | number | Maximum number of blocks within an asset | |
Channels | object | List of channels allowed to use this asset. | |
AllowedBlocks | array | List of blocks allowed in the asset. | |
Slots | object | Slots within the asset. | |
BusinessUnitAvailability | object | A dictionary of member IDs having been granted access to the asset. | |
sharingProperties | object | Allows you to share content with one or more business units having Content Builder Sharing enabled. See Sharing for additional information. | |
sharingProperties.sharedWith | object | List of MID IDs the asset is shared with. | |
sharingProperties.sharingType | string | Indicates the permission that you are granting to the list of MIDs in sharedWith . Possible values are
| |
Template | object | Template that the asset follows. | |
File | string | Base64-encoded string of a file associated with an asset. | |
GenerateFrom | string | Tells the sending compiler what view to use for generating this view's content. | |
400 | Bad request | ||
Message | string | The error message. | |
ErrorCode | number | The specific error code. | |
Documentation | string | Any specific documentation for the error. | |
403 | Permission error | ||
Message | string | The error message. | |
ErrorCode | number | The specific error code. | |
Documentation | string | Any specific documentation for the error. |
The sort syntax is the asset property name followed by the order direction, either asc
or desc
, with a space in between. Sort by multiple property names by separating each sequence with a comma. This example sorts by name in descending order:
Each filter is separated by %20. To use AND and OR operators or to filter by subproperties, use the POST /asset/v1/content/assets/query resource. The following example filters all assets whose name is similar to the value hello world
:
Operator | Description |
---|---|
eq | Equals. Compares numbers and strings. |
neq | Is not equal to. Compares numbers and strings. |
lt | Is less than. Compares numbers only. |
lte | Is less than or equal to. Compares numbers only. |
gt | Is greater than. Compares numbers only. |
gte | Is greater than or equal to. Compares numbers only. |
like | Is similar to. Compares strings only. |
You can query for Archived Assets by including a reference to the Asset Status name of 'Archived' in the $filter parameter, as shown here.