ASaspect
Assets

List Assets

List assets with optional filters and sorting.

This endpoint supports advanced filtering on both asset columns and metadata attributes. Filters are combined with AND logic.

post/assets/list

Request

  • Base URL
    https://api.aspect.inc
  • URL
    https://api.aspect.inc/assets/list
  • Auth
    API key in header Authorization

Request body

parent_idstring uuid required

Parent directory or project ID

recursiveboolean

When true, include assets from all descendant directories

limitinteger

Max results to return

offsetinteger

Pagination offset

is_uploadedboolean nullable

Filter by upload status

Response

Successful Response

idstring uuid required
type'video' | 'image' | 'audio' | 'document' | 'vector' | 'other' required
namestring required
size_bytesinteger required
mime_typestring required
is_uploadedboolean required
is_generatedboolean

Whether this asset was produced by the AI generation pipeline

workspace_idstring uuid required

ID of the workspace this asset belongs to

project_idstring uuid required

ID of the project this asset belongs to

parent_idstring uuid required

ID of the parent resource (directory or project)

comment_countinteger required

Total number of visible comments on this asset, including replies

created_by_user_idstring uuid required

ID of the user that created the asset

version_stack_idstring uuid nullable

Version stack ID. Null if the asset isn't in a stack.

version_numberinteger nullable

Position in the version stack, starting at 1. Null if the asset isn't in a stack.

is_top_versionboolean nullable

True for the top version of a stack. Null if the asset isn't in a stack.

manifest_idstring uuid nullable

ID of the asset's current file content. It changes whenever the content changes. Null when the asset has no content yet.

createdstring date-time required
updatedstring date-time required
content_modified_atstring date-time required

When the asset's file content last changed. Renames and metadata edits don't change it.

Changes

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