aps_get_item_details
Retrieve summarized metadata for a single file or item, including name, type, size, version, and dates, using a project ID and item ID for quick lookups.
Instructions
Get summarised metadata for a single file / item: name, type, size, version number, dates. Much smaller than the raw JSON:API response. Use for quick file lookups when you already have the item_id from a folder listing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Project ID – starts with 'b.'. | |
| item_id | Yes | Item (lineage) URN – starts with 'urn:'. |
Implementation Reference
- src/index.ts:1135-1151 (handler)The handler logic for 'aps_get_item_details' which validates inputs and calls 'apsDmRequest' and 'summarizeItem'.
// ── aps_get_item_details ───────────────────────────────────── if (name === "aps_get_item_details") { const projectId = args.project_id as string; const itemId = args.item_id as string; const e1 = validateProjectId(projectId); if (e1) return fail(e1); const e2 = validateItemId(itemId); if (e2) return fail(e2); const t = await token(); const raw = await apsDmRequest( "GET", `data/v1/projects/${projectId}/items/${encodeURIComponent(itemId)}`, t, ); return json(summarizeItem(raw, { projectId })); }