Skip to main content
GET
Get unredacted Iceberg REST catalog config (machine-to-machine)

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

catalog_name
string
required

Catalog name.

Response

Iceberg REST catalog config retrieved successfully.

Unredacted connection config for a single Iceberg REST catalog.

Machine-to-machine only (general PSK). Unlike /catalogs/details this returns the real OAuth2 credential / token / server-uri (not ***) so the Gravitino Iceberg REST server's config provider can stand up a REST-backed catalog that authenticates upstream.

name
string
required

Catalog name.

uri
string
required

Upstream Iceberg REST catalog URI.

catalog_type
string
default:iceberg

Connector type (always iceberg).

credential
string
default:""

OAuth2 client credential (client-id:client-secret); empty if token auth.

oauth2_server_uri
string
default:""

OAuth2 token endpoint (server-uri) for the client-credentials flow.

token
string
default:""

Bearer token — alternative to the OAuth2 credential flow; empty if unused.

scope
string
default:catalog

OAuth2 scope.

vended_credentials
boolean
default:true

Whether the upstream catalog vends storage credentials.

warehouse
string
default:""

Warehouse identifier (upstream catalog selector).

region
string
default:""

AWS region for S3 storage, if set.