Assets

List assets across all collections

Returns paginated assets spanning every mascot owned by the caller, each annotated with its mascot_id. Filter by type, status, or mascot_id. Set include_file_urls=false for faster metadata-only listings. No credit cost.

Select Masko-API-Version: 2026-09-26 (or api_version=2026-09-26) for the canonical mascot contract shown first. Existing unversioned clients keep legacy collection fields. A mascot_id query filter also selects the canonical contract. Mixing identifier names returns 400.

get/v1/assets

Request

  • Base URL: https://api.masko.ai
  • URL: https://api.masko.ai/v1/assets
  • Auth: HTTP bearer

Query parameters

limitnumber

Page size. 1 to 100. Defaults to 50.

offsetnumber nullable

Number of records to skip. Defaults to 0.

cursorstring

Opaque next_cursor from the previous page. Use instead of offset.

mascot_idstring uuid

Filter to a single mascot. Omit to list across all of your mascots.

typestring

Filter by asset type: image, transparent_image, video, webm, hevc, stacked_video, svg, etc.

is_archived'true' | 'false'

Include archived assets. Defaults to false (active only).

item_idstring uuid

Filter to a single item within a mascot.

include_file_urls'true' | 'false'

Whether to include signed file_url values. Defaults to true. Set false for faster metadata-only listings.

api_version'2026-09-26' | 'legacy'

Equivalent to the version header, for polling URLs and clients that accept only relative paths. Header and query must agree.

collection_idstring uuid

Filter to a single mascot. Omit to list across all of your mascots.

Legacy-only filter. Use mascot_id for new clients; never send both.

Headers

Masko-API-Version'2026-09-26' | 'legacy'

Use 2026-09-26 for mascot_id resource fields. Unversioned shared routes retain the legacy contract.

Response

List of assets across your collections

OR

Changes

No recorded changes to this operation across all 1 revision of this API.