Your connection·private data

List Connection Files

List files in an object-store connection the caller owns (Amazon S3 or Google Cloud Storage). Returns each file's key, size, and last-modified time, confined to the prefix that connection allows. Reads names, not contents.

Requires your own connectionYour S3 or Cloud Storage connection

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: File names inside the connection's allowed bucket prefix. Keys outside it are refused before the request is made.

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 schemaExpand

JSON · 20 lines · 412 chars

Examples (1)

Illustrative only — the ids below are placeholders. Real ids come from list_connections at run time and are scoped to the caller.

List files in an owned bucket prefix

input

JSON · 4 lines · 53 chars

Expected response keys: connection, files

Identifiers

Catalog ID: list_connection_files
Agent tool: list_connection_files
Added: 2026-08-08 00:00Z
Tags: connection, private, read-only, storage, discovery

Access

Works with: ,
Scope: File names inside the connection's allowed bucket prefix. Keys outside it are refused before the request is made.