Namespaces

Retrieve namespace details

Fetches metadata for a specific namespace. Returns the namespace identifier together with its immediate child namespaces, tables, and files. Example Usage: ```bash curl -X GET '/namespaces/my_org.data_warehouse' ```

Last updated on

GET
/namespaces/{namespace}

Path Parameters

namespace*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/namespaces/string"
{
  "success": true,
  "data": {
    "current_namespace": "string",
    "child_namespaces": [
      "string"
    ],
    "tables": [
      "string"
    ],
    "files": [
      "string"
    ]
  }
}
{
  "error": "string",
  "error_code": "string"
}
{
  "message": "string",
  "error_code": "string"
}
{
  "detail": [
    {
      "loc": [
        null
      ],
      "msg": "string",
      "type": "string",
      "input": "string",
      "ctx": {
        "property1": null,
        "property2": null
      }
    }
  ]
}
{
  "error": "string",
  "error_code": "string"
}
{
  "error": "string",
  "error_code": "string"
}

See also

How is this guide?

Retrieve namespace details or root list GET

Fetches metadata for a specific namespace or lists all available root namespaces. Behavior: - With namespace provided: returns the specified namespace's identifier along with its immediate children, including sub-namespaces, tables, and files. - Without namespace: returns a high-level list of all top-level root namespaces available in the catalog. Example Usage: ```bash curl -X GET '/namespaces' ```

Get table schema GET

Retrieves the current logical schema of the Iceberg table. Information provided: - Field IDs used by Iceberg to track columns across renames. - Data types such as string, long, struct, date, timestamp. - Nullability for each field. Example Usage: ```bash curl -X GET '/namespaces/sales.emea/tables/orders/schema' ```