Read Connection File
Read one text file from an object-store connection the caller owns (Amazon S3 or Google Cloud Storage). Only text-like files are readable — markdown, CSV, JSON, XML, logs, sequence and structure formats; images, PDFs and archives are refused. Large files are truncated and say so.
Access
This tool reads a data source you connect. Cortexa hosts no dataset behind it and nothing here is publicly queryable — there is no result to show a visitor, only the shape of the call. Add a connection in Settings → Connections, and the agent can use it in your own sessions.
- Works with
- ,
- Scope
- One object inside the connection's allowed bucket prefix, capped at 2 MB of text.
Access is read-only and re-authorized on every call against the connection's owner, your active workspace, and any explicit grants. Credentials stay encrypted at rest and are never returned by a tool.
Schema
JSON Schema the agent (or your API call) must match.
View JSON schemaExpandCollapse
Examples (1)
Illustrative only — the ids below are placeholders. Real ids come from list_connections at run time and are scoped to the caller.
Read a document from an owned bucket
Identifiers
- Catalog ID
- read_connection_file
- Agent tool
- read_connection_file
- Added
- 2026-08-08 00:00Z
- Tags
- connection, private, read-only, storage, document