Assets

Assets

List, retrieve, update, and move assets to the trash from the Developer API.

Asset responses include the stored asset representation and processing metadata. All management operations are scoped to the authenticated workspace.

Authentication: management API endpoints require a Clerk bearer token.https://api.vyso.io/v1/...

Endpoints

GET/v1/assets

List assets

  • Query filters include view, search, assetType, dateAdded, orientation, assetSize, assetFormat, assignment, metadataStatus, collectionId, fav, sort, offset, limit, and cursor.
  • The response includes count, total, offset, limit, nextCursor, and assets.
curl -i "https://api.vyso.io/v1/assets?limit=50&sort=newest" -H "Authorization: Bearer $CLERK_SESSION_TOKEN"
GET/v1/assets/:assetId

Retrieve one asset

  • Returns 404 when the asset is not available to the authenticated workspace.
PATCH/v1/assets/:assetId

Update asset metadata or collection assignment

  • Supported fields include filename, caption, tags, userTitle, userDescription, userCaption, userTags, fav, collection, collectionId, and the supported transform options.
DELETE/v1/assets/:assetId

Move an asset to trash

  • Deletion is workspace-scoped and uses the asset identifier in the path.
Back to Developer APIExplore CDN delivery