API ReferenceAssets

Get asset by ID

Beta

Retrieve a single asset by its ID. Returns comprehensive metadata including creation info, tags, timestamps, media type, and AI-generated summary.

Authentication

X-API-KEYstring
API Key authentication via header
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

asset_idstringRequired

Response

Successfully retrieved asset
athena_converted_typestring

File type after Athena processing/conversion (e.g., ‘txt’, ‘pdf’, ‘md’)

athena_original_typestring

Original asset type from AssetType enum (e.g., ‘document’, ‘presentation’, ‘spreadsheet’)

created_atstringformat: "date-time"

Timestamp when the asset was created (ISO 8601 format)

created_by_idstring
Unique identifier of the user who created this asset
is_archivedboolean

Whether the asset has been archived (hidden from normal views)

is_hiddenboolean
Whether the asset is hidden from the user interface
media_typestring

MIME type or Athena-specific media type (e.g., ‘text/plain’, ‘application/pdf’, ‘athena/document’)

summary_readyboolean
Whether the AI summary has been generated and is available
titlestring

Display name/title of the asset

updated_atstringformat: "date-time"

Timestamp when the asset was last modified (ISO 8601 format)

athena_metadatamap from strings to any or null

Internal metadata used by Athena system (e.g., {‘source’: ‘kb’, ‘topic’: ‘insights’})

created_by_emailstring or null
Email address of the user who created this asset
summarystring or null

AI-generated summary of the asset content

summary_statusstring or null

Status of summary generation process (‘READY’, ‘PENDING’, ‘FAILED’, etc.)

tagsmap from strings to any or null

Custom tags associated with the asset as key-value pairs (e.g., {‘project’: ‘alpha’, ‘team’: ‘ml’})

Errors