Request vended storage credentials from an Iceberg REST catalog when loading a table

domain: data-engineering · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Send GET /v1/{prefix}/namespaces/{namespace}/tables/{table} with header X-Iceberg-Access-Delegation set to a comma-separated list of supported mechanisms, e.g. "vended-credentials,remote-signing".
  2. Remember the server may honor any, none, or a subset of the requested mechanisms — don't assume compliance.
  3. Check the LoadTableResult response for a storage-credentials array first; each entry has a prefix (path scope) and a config map of credential key/value pairs.
  4. Only fall back to reading credentials from the top-level config map if storage-credentials is absent — the spec states storage-credentials takes priority.
  5. Match each storage-credentials entry's prefix against the table's actual data file paths, since a catalog can scope different credentials to different path prefixes.

Known gotchas

Related routes

Load a table and commit an update using the Iceberg REST catalog protocol
iceberg.apache.org · 5 steps · unrated
Register and query an Iceberg table through the Unity Catalog OSS REST API
docs.unitycatalog.io · 5 steps · unrated
Attach to an Iceberg REST catalog in DuckDB
duckdb.org · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans