Get asset by ID | Athena | API Reference Docs

{
  "athena_converted_type": "pdf",
  "athena_original_type": "document",
  "created_at": "2024-01-15T10:30:00Z",
  "created_by_id": "user_123",
  "id": "asset_92492920-d118-42d3-95b4-00eccfe0754f",
  "is_archived": false,
  "is_hidden": false,
  "media_type": "application/pdf",
  "summary_ready": true,
  "title": "Quarterly Report Q1 2024",
  "updated_at": "2024-01-16T14:20:00Z",
  "athena_metadata": {
    "source": "upload",
    "topic": "finance"
  },
  "created_by_email": "user@example.com",
  "parent_folder_id": "asset_folder_1a2b3c",
  "summary": "Comprehensive quarterly financial report covering revenue, expenses, and growth metrics.",
  "summary_status": "READY",
  "tags": {
    "project": "alpha",
    "team": "ml"
  },
  "workspace_id": "ws_abc123-def456"
}

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

Path parameters

asset_idstringRequired

Unique identifier of the asset to retrieve

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_atdatetime

Timestamp when the asset was created (ISO 8601 format)

created_by_idstring

Unique identifier of the user who created this asset

idstring

Unique identifier of the asset (e.g., ‘asset_abc123-def456-ghi789’)

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_atdatetime

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

athena_metadatamap from strings to any or nullOptional

Internal metadata used by Athena system (e.g., {‘source’: ‘kb’, ‘topic’: ‘insights’}). Never carries a stored credential: connection-string passwords are masked as ’****’ and secret keys are removed; last_read_at holds only the caller’s own read receipt.

created_by_emailstring or nullOptional

Email address of the user who created this asset

import_reportobject or nullOptional

For a Word document, spreadsheet or presentation imported from an Office file: what the file holds that is not shown, or is shown differently than in Office, and whether downloads keep it. Null when the import lost nothing, when the asset was not imported from a file, or when it was imported before these reports were kept.

parent_folder_idstring or nullOptional

ID of the folder that directly contains this asset, or null when the asset is at the workspace root

summarystring or nullOptional

AI-generated summary of the asset content

summary_statusstring or nullOptional

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

tagsmap from strings to any or nullOptional

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

workspace_idstring or nullOptional

Unique identifier of the workspace this asset belongs to

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

Authentication

Path parameters

Headers

Response

Errors