Describe Connection Schema
Inspect the schema of one SQL connection the caller owns (Postgres or BigQuery): tables and their columns, restricted to the schemas or datasets that connection allows. Reads structure, not rows.
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
- Postgres, BigQuery
- Scope
- Table and column names inside the connection's allowed schemas or datasets.
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.
Introspect an owned SQL connection
Identifiers
- Catalog ID
- describe_connection
- Agent tool
- describe_connection
- Added
- 2026-07-26 09:40Z
- Tags
- connection, private, read-only, sql, schema