Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Table Format Tables API

Table creation, listing, loading, and management

Table Format Tables API is one of 8 APIs that Table Format publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Tables. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 3 paths, and defines 14 schemas. It is described by OpenAPI 3.0.3, at version 0.0.1.

Requests are made against a single base URL, https://{catalog-host}.

6 operations 3 paths 14 schemas 1 DELETE2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
0.0.1
Base URL
https://catalog-service/
Authentication
HTTP Bearer, OAuth 2.0
License
Resource Areas
1

Authentication & Security 2

Table Format Tables API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). It supports OAuth 2.0 (OAuth2) using the clientCredentials flow, exposing 1 scope. By default, every request must be authenticated.

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Tables 6

Table creation, listing, loading, and management

GET
/v1/namespaces/{namespace}/tables
List Tables
listTables 3 params → 200
POST
/v1/namespaces/{namespace}/tables
Create Table
createTable 1 param body → 200409
GET
/v1/namespaces/{namespace}/tables/{table}
Load Table
loadTable 3 params → 200404
POST
/v1/namespaces/{namespace}/tables/{table}
Commit Table Update
commitTable 2 params body → 200409
DELETE
/v1/namespaces/{namespace}/tables/{table}
Drop Table
dropTable 3 params → 204404
POST
/v1/namespaces/{namespace}/tables/{table}/metrics
Report Table Metrics
reportMetrics 2 params body → 204

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are TableMetadata (11 properties), CreateTableRequest (7 properties), Snapshot (6 properties), StructField (5 properties). Each schema is shown below with its type and property counts.

IcebergErrorResponse
object
1 property
CreateTableRequest
object
7 properties 2 required
ReportMetricsRequest
object
2 properties
ListTablesResponse
object
2 properties
StructField
object
5 properties
Snapshot
object
6 properties
SortOrder
object
2 properties
TableIdentifier
object
2 properties
LoadTableResult
object
3 properties
TableMetadata
object
11 properties
Schema
object
2 properties
PartitionSpec
object
2 properties
CommitTableRequest
object
3 properties 2 required
CommitTableResponse
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

table-format-tables-api-openapi.yml Raw ↑

Other APIs Table Format publishes across the network.

Delta Lake
Apache Hudi
Table Format Commits API
Table Format Configuration API
Table Format Namespaces API
Table Format OAuth2 API
Table Format Views API