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

Keboola Tables API

The Tables API from Keboola — 13 operation(s) for tables.

Keboola Tables API is one of 79 APIs that Keboola 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 17 operations across 13 paths, and defines 22 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against the base URL https://connection.keboola.com/v2/storage.

17 operations 13 paths 22 schemas 2 DELETE6 GET7 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://connection.keboola.com/v2/storage
Authentication
API Key
License
Resource Areas
1

Authentication & Security 1

Keboola Tables API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-StorageApi-Token (ApiKeyAuth).

Paths & Operations 17

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

Tables 17
POST
/v2/storage/branch/{branchId}/tables/{id}/columns
Create columns in a table
post_/v2/storage/branch/{branchId}/tables/{id}/columns::ColumnCreateAction 3 params body → 202400
POST
/v2/storage/tables/{id}/columns
Create columns in a table
post_/v2/storage/tables/{id}/columns::ColumnCreateAction 2 params body → 202400
GET
/v2/storage/branch/{branchId}/tables/{id}/snapshots
List table snapshots
get_/v2/storage/branch/{branchId}/tables/{id}/snapshots::TableSnapshotsListAction 4 params → 200404403503
POST
/v2/storage/branch/{branchId}/tables/{id}/snapshots
Create table snapshot
post_/v2/storage/branch/{branchId}/tables/{id}/snapshots::TableSnapshotCreateAction 3 params body → 404400403503202
GET
/v2/storage/tables/{id}/snapshots
List table snapshots
get_/v2/storage/tables/{id}/snapshots::TableSnapshotsListAction 3 params → 200404403503
POST
/v2/storage/tables/{id}/snapshots
Create table snapshot
post_/v2/storage/tables/{id}/snapshots::TableSnapshotCreateAction 2 params body → 404400403503202
GET
/v2/storage/branch/{branchId}/tables/{id}/metadata
List table metadata
get_/v2/storage/branch/{branchId}/tables/{id}/metadata::TableGetMetadataAction 2 params → 200404403
POST
/v2/storage/branch/{branchId}/tables/{id}/metadata
Create or update table metadata
post_/v2/storage/branch/{branchId}/tables/{id}/metadata::TableCreateOrUpdateMetadataAction 2 params body → 201404403
GET
/v2/storage/tables/{id}/metadata
List table metadata
get_/v2/storage/tables/{id}/metadata::TableGetMetadataAction 1 param → 200404403
POST
/v2/storage/tables/{id}/metadata
Create or update table metadata
post_/v2/storage/tables/{id}/metadata::TableCreateOrUpdateMetadataAction 1 param body → 201404403
PUT
/v2/storage/branch/{branchId}/tables/{tableId}/definition
Update table definition
put_/v2/storage/branch/{branchId}/tables/{tableId}/definition::TableDefinitionUpdateAction 3 params → 404400403422202
PUT
/v2/storage/tables/{tableId}/definition
Update table definition
put_/v2/storage/tables/{tableId}/definition::TableDefinitionUpdateAction 2 params → 404400403422202
GET
/v2/storage/branch/{branchId}/tables/{id}
Get table detail
get_/v2/storage/branch/{branchId}/tables/{id}::TableDetailAction 2 params → 200404403
GET
/v2/storage/tables/{id}
Get table detail
get_/v2/storage/tables/{id}::TableDetailAction 1 param → 200404403
DELETE
/v2/storage/branch/{branchId}/tables/{id}/metadata/{metadataId}
Delete table metadata
delete_/v2/storage/branch/{branchId}/tables/{id}/metadata/{metadataId}::TableDeleteMetadataAction 3 params → 204404403
DELETE
/v2/storage/tables/{id}/metadata/{metadataId}
Delete table metadata
delete_/v2/storage/tables/{id}/metadata/{metadataId}::TableDeleteMetadataAction 2 params → 204404403
POST
/v2/storage/branch/{branchId}/tables/{tableId}/swap
Swap two tables
post_/v2/storage/branch/{branchId}/tables/{tableId}/swap::TableSwapAction 2 params body → 400404403422202

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are TableDetailResponse (31 properties), RefreshJobResponse (27 properties), TableCreateResponse (26 properties), FileDeleteResponse (14 properties). Each schema is shown below with its type and property counts.

BucketListingCreateJobResult
object
4 properties 4 required
BucketListingDeleteResponse
object
14 properties 8 required
TableSnapshotCreateJobResult
object
7 properties 6 required
SourceTableResponse
object
4 properties 4 required
TableCreateOrUpdateMetadataResponse
object
2 properties 2 required
TableSwapRequest
object
1 property 1 required
TableCreateResponse
object
26 properties 22 required
RefreshJobResponse
object
27 properties 18 required
BigqueryAddColumnToTableRequest
object
Request for adding a column to a BigQuery table.
2 properties 2 required
FileDeleteResponse
object
14 properties 8 required
CreateTableMetadataRequest
object
SwapJobParams
object
3 properties 3 required
CreateSnapshotRequest
object
1 property
TableDefinitionUpdateJobParams
object
10 properties 8 required
ColumnCreateRequest
object
Request for adding a column to a table.
2 properties 1 required
JobResponse
object
Response object for an asynchronous storage job.
14 properties 10 required
TableSwapResult
object
2 properties 2 required
MetadataItemResponse
object
Single metadata record.
5 properties 5 required
SnowflakeAddColumnToTableRequest
object
Request for adding a column to a Snowflake table.
2 properties 2 required
TableDetailResponse
object
31 properties 19 required
TableExportJobResponse
object
1 property
BucketListingUpdateJobResponse
object
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

keboola-tables-api-openapi.yml Raw ↑

Other APIs Keboola publishes across the network.

Keboola Actions API
Keboola Admin Apps API
Keboola Admin Stacks API
Keboola Admin Users API
Keboola Admin Vendors API
Keboola App API
Keboola Auth API
Keboola Authorize API
Keboola Branch metadata API
Keboola Buckets API
Keboola Columns API
Keboola Component Configuration Metadata API