{
  "opencollection": "1.0.0",
  "info": {
    "name": "Apache Iceberg REST Catalog API",
    "version": "0.0.1"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Configuration",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Catalog Configuration",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{catalog-host}/v1/config",
            "params": [
              {
                "name": "warehouse",
                "value": "",
                "type": "query",
                "description": "Warehouse identifier for multi-tenant catalogs"
              }
            ]
          },
          "docs": "Returns configuration properties for the catalog and default table properties, plus catalog-level overrides. Used during client initialization to discover catalog configuration."
        }
      ]
    },
    {
      "info": {
        "name": "OAuth2",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get OAuth2 Token",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{catalog-host}/v1/oauth/tokens",
            "body": {
              "type": "form-urlencoded",
              "data": [
                {
                  "name": "grant_type",
                  "value": ""
                },
                {
                  "name": "client_id",
                  "value": ""
                },
                {
                  "name": "client_secret",
                  "value": ""
                },
                {
                  "name": "scope",
                  "value": ""
                }
              ]
            }
          },
          "docs": "Exchange credentials for an OAuth2 access token for catalog access."
        }
      ]
    },
    {
      "info": {
        "name": "Namespaces",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Namespaces",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{catalog-host}/v1/namespaces",
            "params": [
              {
                "name": "parent",
                "value": "",
                "type": "query",
                "description": "Parent namespace (for nested namespaces)"
              },
              {
                "name": "pageToken",
                "value": "",
                "type": "query"
              },
              {
                "name": "pageSize",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "List all namespaces. A namespace is a container for tables, analogous to a database or schema."
        },
        {
          "info": {
            "name": "Create Namespace",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{catalog-host}/v1/namespaces",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new namespace with optional properties."
        },
        {
          "info": {
            "name": "Get Namespace Metadata",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{catalog-host}/v1/namespaces/:namespace",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              }
            ]
          },
          "docs": "Load metadata properties for a namespace."
        },
        {
          "info": {
            "name": "Drop Namespace",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://{catalog-host}/v1/namespaces/:namespace",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              }
            ]
          },
          "docs": "Drop a namespace. The namespace must be empty."
        },
        {
          "info": {
            "name": "Update Namespace Properties",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/properties",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Set or remove namespace properties."
        }
      ]
    },
    {
      "info": {
        "name": "Tables",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Tables",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/tables",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              },
              {
                "name": "pageToken",
                "value": "",
                "type": "query"
              },
              {
                "name": "pageSize",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "List all tables in a namespace."
        },
        {
          "info": {
            "name": "Create Table",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/tables",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new Iceberg table in the given namespace."
        },
        {
          "info": {
            "name": "Load Table",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/tables/:table",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              },
              {
                "name": "table",
                "value": "",
                "type": "path",
                "description": "Table name"
              },
              {
                "name": "snapshots",
                "value": "",
                "type": "query",
                "description": "Which snapshots to return (all, refs, or none)"
              }
            ]
          },
          "docs": "Load a table from the catalog, returning metadata and a token for updates."
        },
        {
          "info": {
            "name": "Commit Table Update",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/tables/:table",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              },
              {
                "name": "table",
                "value": "",
                "type": "path",
                "description": "Table name"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Commit a set of table requirement assertions and metadata updates atomically."
        },
        {
          "info": {
            "name": "Drop Table",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/tables/:table",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              },
              {
                "name": "table",
                "value": "",
                "type": "path",
                "description": "Table name"
              },
              {
                "name": "purgeRequested",
                "value": "",
                "type": "query",
                "description": "Whether to purge table data files"
              }
            ]
          },
          "docs": "Drop a table from the catalog. Optionally purge the data files."
        },
        {
          "info": {
            "name": "Report Table Metrics",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/tables/:table/metrics",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              },
              {
                "name": "table",
                "value": "",
                "type": "path",
                "description": "Table name"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Send scan metrics and commit metrics to the catalog for observability."
        }
      ]
    },
    {
      "info": {
        "name": "Views",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Views",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/views",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              }
            ]
          },
          "docs": "List all views in a namespace."
        },
        {
          "info": {
            "name": "Create View",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/views",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new Iceberg view in the namespace."
        },
        {
          "info": {
            "name": "Load View",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/views/:view",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              },
              {
                "name": "view",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Load a view from the catalog."
        },
        {
          "info": {
            "name": "Drop View",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://{catalog-host}/v1/namespaces/:namespace/views/:view",
            "params": [
              {
                "name": "namespace",
                "value": "",
                "type": "path",
                "description": "Namespace identifier (can be multi-level with ASCII unit separator)"
              },
              {
                "name": "view",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Drop a view from the catalog."
        }
      ]
    },
    {
      "info": {
        "name": "Commits",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Commit Multi-Table Transaction",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{catalog-host}/v1/transactions/commit",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Atomically commit updates to multiple tables in a single transaction."
        }
      ]
    }
  ],
  "bundled": true
}