Skip to navigation
API ReferenceAssets

List assets

Beta

Retrieve a paginated list of assets with optional filtering and sorting. Assets include documents, presentations, spreadsheets, images, videos, and other file types managed by Athena Intelligence.

Authentication

X-API-KEYstring
API Key authentication via header

Headers

X-Athena-Session-CredentialstringOptional

Query parameters

limitintegerOptional1-500Defaults to 50

Maximum number of assets to return per page (1-500)

offsetintegerOptional>=0Defaults to 0
Number of assets to skip for pagination
filtersstring or nullOptional

JSON string of filter criteria. Supports: created_by_id, created_by_email, tags, created_after/before, updated_after/before, title_substring, is_archived, is_hidden, athena_metadata, media_type, athena_converted_type, athena_original_type, summary_ready, summary_status, workspace_id

sortstring or nullOptional

JSON string of sort criteria: [{"field": "updated_at", "direction": "desc"}]. Supported fields: created_by_id, created_by_email, created_at, updated_at, is_archived, is_hidden, summary_ready, summary_status

workspace_idstring or nullOptional
Workspace to list assets from. Caller must be a member.

Response

Successfully retrieved paginated list of assets
has_moreboolean
Whether there are more assets available beyond this page
itemslist of objects
Array of asset objects for the current page
limitinteger

Maximum number of assets returned in this response (1-500)

next_offsetinteger or null
Offset value to use for the next page request, null if no more pages
offsetinteger
Number of assets skipped from the beginning of the result set
totalinteger
Total number of assets matching the query filters

Errors

422
Unprocessable Entity Error