Read one or more assets with anchors, formats, and pagination | Athena

curl -X POST https://api.athenaintel.com/api/v0/tools/asset/read \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "asset_ids": [
    "asset_9249292-d118-42d3-95b4-00eccfe0754f?anchor=page&page=1&format=text"
  ]
}'

{
  "results": [
    {
      "asset_id": "asset_9249292-d118-42d3-95b4-00eccfe0754f",
      "content": "Page 1 text...",
      "format": "text",
      "asset_type": "pdf",
      "is_error": false,
      "read_capabilities": {
        "asset_type": "pdf",
        "default_format": "text",
        "formats": [
          "text",
          "image"
        ],
        "anchors": [
          "page",
          "page_range",
          "page_rect",
          "page_text"
        ],
        "pagination": "page_range",
        "preferred_anchors": [
          "page",
          "page_text",
          "page_rect"
        ]
      }
    }
  ]
}

Read one or more assets with citation-style anchors, output format selection (text/json/image), and pagination. Each result discloses the asset type’s read capabilities and returns a structured teaching error when a read fails. Mirrors the agent’s read_asset tool.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

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

Request

This endpoint expects an object.

asset_idslist of stringsRequired

1-10 asset identifiers to read. Each id may carry inline read options using citation-style query syntax, e.g. ‘asset_xxx?anchor=page&page=3&format=image’. Versioned (‘asset_xxx@version’) and live (‘asset_xxx_providerId’) ids are supported.

passwordstring or nullOptional

Optional password for reading password-protected Office files. Applied to every asset in the request.

Response

Successful Response

resultslist of objects

One result per requested asset, in request order

Errors

401

Unauthorized Error

422

Unprocessable Entity Error