How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Lakekeeper Catalog API

The Catalog API API from Lakekeeper — 16 operation(s) for catalog api.

Lakekeeper Catalog API is one of 13 APIs that Lakekeeper publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Catalog API. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and pricing.

This API exposes 28 operations across 16 paths, and defines 141 schemas. It is described by OpenAPI 3.2.0, at version 0.0.1.

Requests are made against 2 base URLs: {scheme}://{host}/{basePath}, {scheme}://{host}:{port}/{basePath}.

28 operations 16 paths 141 schemas 4 DELETE8 GET3 HEAD13 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.0.1
Base URL
{scheme}://{host}/management/v1
Authentication
OAuth 2.0, HTTP Bearer
License
Resource Areas
1

Authentication & Security 2

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

  • OAuth2 — This scheme is used for OAuth2 authorization. For unauthorized requests, services should return an appropriate 401 or 403 response. Implementations must not re…

Paths & Operations 28

Across 16 paths, the API surfaces 28 operations — 4 DELETE, 8 GET, 3 HEAD, 13 POST. Each is listed below with its method, path, parameters, and response codes.

Catalog API 28
GET
/v1/{prefix}/namespaces
List namespaces, optionally providing a parent namespace to list underneath
listNamespaces 6 params → 2004004014034044195035XX
POST
/v1/{prefix}/namespaces
Create a namespace
createNamespace 2 params body → 200400401403406409419503
GET
/v1/{prefix}/namespaces/{namespace}
Load the metadata properties for a namespace
loadNamespaceMetadata 3 params → 2004004014034044195035XX
HEAD
/v1/{prefix}/namespaces/{namespace}
Check if a namespace exists
namespaceExists 2 params → 2044004014034044195035XX
DELETE
/v1/{prefix}/namespaces/{namespace}
Drop a namespace from the catalog.
dropNamespace 6 params → 204400401403404409419503
POST
/v1/{prefix}/namespaces/{namespace}/properties
Set or remove properties on a namespace
updateProperties 3 params body → 200400401403404406422419
GET
/v1/{prefix}/namespaces/{namespace}/tables
List all table identifiers underneath a given namespace
listTables 6 params → 2004004014034044195035XX
POST
/v1/{prefix}/namespaces/{namespace}/tables
Create a table in the given namespace
createTable 4 params body → 200400401403404409419503
POST
/v1/{prefix}/namespaces/{namespace}/tables/{table}/plan
Submit a scan for planning
planTableScan 5 params body → 200400401403404406419503
GET
/v1/{prefix}/namespaces/{namespace}/tables/{table}/plan/{plan-id}
Fetches the result of scan planning for a plan-id
fetchPlanningResult 5 params → 2004004014034044195035XX
DELETE
/v1/{prefix}/namespaces/{namespace}/tables/{table}/plan/{plan-id}
Cancels scan planning for a plan-id
cancelPlanning 6 params → 2044004014034044195035XX
POST
/v1/{prefix}/namespaces/{namespace}/tables/{table}/tasks
Fetches result tasks for a plan task
fetchScanTasks 4 params body → 2004004014034044195035XX
POST
/v1/{prefix}/namespaces/{namespace}/register
Register a table in the given namespace using given metadata file location
registerTable 4 params body → 200400401403404409419503
GET
/v1/{prefix}/namespaces/{namespace}/tables/{table}
Load a table from the catalog
loadTable 7 params → 200304400401403404419503
POST
/v1/{prefix}/namespaces/{namespace}/tables/{table}
Commit updates to a table
updateTable 4 params body → 200400401403404409419500
DELETE
/v1/{prefix}/namespaces/{namespace}/tables/{table}
Drop a table from the catalog
dropTable 6 params → 2044004014034044195035XX
HEAD
/v1/{prefix}/namespaces/{namespace}/tables/{table}
Check if a table exists
tableExists 3 params → 2044004014034044195035XX
GET
/v1/{prefix}/namespaces/{namespace}/tables/{table}/credentials
Load vended credentials for a table from the catalog
loadCredentials 5 params → 2004004014034044195035XX
POST
/v1/{prefix}/tables/rename
Rename a table from its current name to a new name
renameTable 2 params body → 204400401403404406409419
POST
/v1/{prefix}/namespaces/{namespace}/tables/{table}/metrics
Send a metrics report to this endpoint to be processed by the backend
reportMetrics 3 params body → 2044004014034044195035XX
POST
/v1/{prefix}/transactions/commit
Commit updates to multiple tables in an atomic operation
commitTransaction 2 params body → 204400401403404409419500
GET
/v1/{prefix}/namespaces/{namespace}/views
List all view identifiers underneath a given namespace
listViews 6 params → 2004004014034044195035XX
POST
/v1/{prefix}/namespaces/{namespace}/views
Create a view in the given namespace
createView 2 params body → 200400401403404409419503
GET
/v1/{prefix}/namespaces/{namespace}/views/{view}
Load a view from the catalog
loadView 4 params → 2004004014034044195035XX
POST
/v1/{prefix}/namespaces/{namespace}/views/{view}
Replace a view
replaceView 4 params body → 200400401403404409419500
DELETE
/v1/{prefix}/namespaces/{namespace}/views/{view}
Drop a view from the catalog
dropView 5 params → 2044004014034044195035XX
HEAD
/v1/{prefix}/namespaces/{namespace}/views/{view}
Check if a view exists
viewExists 3 params → 2044004014044195035XX
POST
/v1/{prefix}/views/rename
Rename a view from its current name to a new name
renameView 2 params body → 204400401403404406409419

Schemas 141

The contract defines 141 schemas that model the data the API accepts and returns. The most detailed are TableMetadata (23 properties), ContentFile (10 properties), Snapshot (9 properties), PlanTableScanRequest (9 properties). Each schema is shown below with its type and property counts.

CreateViewRequest
object
5 properties 4 required
Expression
TimestampTzNanoTypeValue
string
Timestampns type values follow the 'YYYY-MM-DDTHH:MM:SS.sssssssss+00:00' ISO-8601 format with nanosecond precision, and a timezone offset (+00:00 for UTC)
TransformTerm
object
3 properties 3 required
CompletedPlanningWithIDResult
object
SetCurrentSchemaUpdate
object
2 properties 1 required
FixedTypeValue
string
Fixed length type values are stored and serialized as an uppercase hexadecimal string preserving the fixed length
SetDefaultSortOrderUpdate
object
2 properties 1 required
MapType
object
6 properties 6 required
LoadViewResult
object
Result used when a view is successfully loaded. The view metadata JSON is returned in the metadata field. The corresponding file location of view metadata is r…
3 properties 2 required
SetSnapshotRefUpdate
object
2 properties 1 required
AssertViewUUID
object
The view UUID must match the requirement's uuid
2 properties 2 required
BaseUpdate
object
1 property 1 required
EqualityDeleteFile
object
2 properties 1 required
RemoveStatisticsUpdate
object
2 properties 1 required
Term
StructField
object
7 properties 4 required
EmptyPlanningResult
object
Empty server-side planning result
1 property 1 required
LongTypeValue
integer
NotExpression
object
2 properties 2 required
UpdateNamespacePropertiesRequest
object
2 properties
FieldName
string
A full field name (including parent field names), such as those passed in APIs like Java SchemafindField(String name). The nested field name follows these rule…
SnapshotLog
array
TableIdentifier
object
2 properties 2 required
PartitionField
object
4 properties 3 required
CreateNamespaceResponse
object
2 properties 1 required
FileFormat
string
Snapshot
object
9 properties 4 required
PrimitiveType
string
DataFile
object
8 properties 1 required
Metrics
object
RemoveEncryptionKeyUpdate
object
2 properties 1 required
PositionDeleteFile
object
3 properties 1 required
SetPropertiesUpdate
object
2 properties 1 required
NullOrder
string
SnapshotReferences
object
UpdateNamespacePropertiesResponse
object
3 properties 2 required
TrueExpression
object
1 property 1 required
TableMetadata
object
23 properties 2 required
ScanTasks
object
Scan and planning tasks for server-side scan planning - plan-tasks contains opaque units of planning work - file-scan-tasks contains a partial or complete list…
3 properties
PlanTableScanRequest
object
9 properties
CounterResult
object
2 properties 2 required
RemoveSnapshotRefUpdate
object
2 properties 1 required
AssignUUIDUpdate
object
Assigning a UUID to a table/view should only be done when creating the table/view. It is not safe to re-assign the UUID if a table/view already has a UUID assi…
2 properties 1 required
CommitTransactionRequest
object
1 property 1 required
LiteralExpression
object
3 properties 3 required
CreateNamespaceRequest
object
2 properties 1 required
TimerResult
object
3 properties 3 required
SortDirection
string
ExpressionType
string
FetchPlanningResult
object
Result of server-side scan planning for fetchPlanningResult
TimestampNanoTypeValue
string
Timestampns type values follow the 'YYYY-MM-DDTHH:MM:SS.sssssssss' ISO-8601 format with nanosecond precision
LoadTableResult
object
Result used when a table is successfully loaded. The table metadata JSON is returned in the metadata field. The corresponding file location of table metadata s…
4 properties 1 required
SetDefaultSpecUpdate
object
2 properties 1 required
AddPartitionSpecUpdate
object
2 properties 1 required
StringTypeValue
string
TimeTypeValue
string
Time type values follow the 'HH:MM:SS.ssssss' ISO-8601 format with microsecond precision
SortField
object
4 properties 4 required
UUIDTypeValue
string
UUID type values are serialized as a 36-character lowercase string in standard UUID format as specified by RFC-4122
DoubleTypeValue
number
DecimalTypeValue
string
Decimal type values are serialized as strings. Decimals with a positive scale serialize as numeric plain text, while decimals with a negative scale use scienti…
ErrorModel
object
JSON error payload returned in a response with further details on the error
4 properties 3 required
ListNamespacesResponse
object
4 properties
AddEncryptionKeyUpdate
object
2 properties 1 required
SQLViewRepresentation
object
3 properties 3 required
SnapshotReference
object
5 properties 2 required
CommitTableRequest
object
3 properties 2 required
IntegerTypeValue
integer
BooleanTypeValue
boolean
SetStatisticsUpdate
object
3 properties 1 required
StorageCredential
object
2 properties 2 required
CreateTableRequest
object
7 properties 2 required
AddSortOrderUpdate
object
2 properties 1 required
FloatTypeValue
number
PageToken
string
An opaque token that allows clients to make use of pagination for list APIs (e.g. ListTables). Clients may initiate the first paginated request by sending an e…
PlanTask
string
An opaque string provided by the REST server that represents a unit of work to produce file scan tasks for scan planning. This allows clients to fetch tasks ac…
ScanReport
object
8 properties 7 required
ViewRepresentation
IcebergErrorResponse
object
JSON wrapper for all error responses (non-2xx)
1 property 1 required
ValueMap
object
2 properties
UpgradeFormatVersionUpdate
object
2 properties 1 required
EncryptedKey
object
4 properties 2 required
FetchScanTasksRequest
object
1 property 1 required
PartitionSpec
object
2 properties 1 required
Schema
BinaryTypeValue
string
Binary type values are stored and serialized as an uppercase hexadecimal string
AndOrExpression
object
3 properties 3 required
MetadataLog
array
FileScanTask
object
3 properties 1 required
DeleteFile
Namespace
array
Reference to one or more levels of a namespace
PrimitiveTypeValue
TableUpdate
TimestampTzTypeValue
string
TimestampTz type values follow the 'YYYY-MM-DDTHH:MM:SS.ssssss+00:00' ISO-8601 format with microsecond precision, and a timezone offset (+00:00 for UTC)
RenameTableRequest
object
2 properties 2 required
LoadCredentialsResponse
object
1 property 1 required
SetCurrentViewVersionUpdate
object
2 properties 1 required
Type
AsyncPlanningResult
object
2 properties 2 required
ViewRequirement
object
Transform
string
ViewHistoryEntry
object
2 properties 2 required
ListTablesResponse
object
4 properties
Reference
string
ContentFile
object
10 properties 7 required
UnaryExpression
object
2 properties 2 required
AddSchemaUpdate
object
3 properties 1 required
RemovePartitionSpecsUpdate
object
2 properties 1 required
StatisticsFile
object
5 properties 5 required
CommitViewRequest
object
3 properties 1 required
BlobMetadata
object
5 properties 4 required
StructType
object
2 properties 2 required
ReportMetricsRequest
object
1 property 1 required
TableRequirement
object
1 property 1 required
FailedPlanningResult
object
Failed server-side planning result
MetricResult
ViewMetadata
object
8 properties 7 required
CountMap
object
2 properties
PartitionStatisticsFile
object
3 properties 3 required
SortOrder
object
2 properties 2 required
DateTypeValue
string
Date type values follow the 'YYYY-MM-DD' ISO-8601 standard date format
PlanStatus
string
Status of a server-side planning operation
AddSnapshotUpdate
object
2 properties 1 required
RemoveSchemasUpdate
object
2 properties 1 required
ListType
object
4 properties 4 required
FetchScanTasksResult
object
Response schema for fetchScanTasks
RemovePropertiesUpdate
object
2 properties 1 required
PlanTableScanResult
object
Result of server-side scan planning for planTableScan
SetLocationUpdate
object
2 properties 1 required
RemoveSnapshotsUpdate
object
2 properties 1 required
ViewVersion
object
7 properties 6 required
AddViewVersionUpdate
object
2 properties 1 required
SetExpression
object
3 properties 3 required
ViewUpdate
FalseExpression
object
1 property 1 required
CompletedPlanningResult
object
Completed server-side planning result
CommitTableResponse
object
2 properties 2 required
TimestampTypeValue
string
Timestamp type values follow the 'YYYY-MM-DDTHH:MM:SS.ssssss' ISO-8601 format with microsecond precision
GetNamespaceResponse
object
3 properties 1 required
RegisterTableRequest
object
3 properties 2 required
CommitReport
object
6 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

lakekeeper-catalog-api-api-openapi.yml Raw ↑

Other APIs Lakekeeper publishes across the network.

Lakekeeper Generic Table (Data) API
Lakekeeper Authorization API
Lakekeeper Configuration API
Lakekeeper OAuth2 API
Lakekeeper Permissions Cedar API
Lakekeeper Permissions Openfga API
Lakekeeper Project API
Lakekeeper Role API
Lakekeeper Server API
Lakekeeper Tasks API
Lakekeeper User API
Lakekeeper Warehouse API
Where this information came from

This is an independent, third-party profile of Lakekeeper Catalog API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.