Register Table
const url = 'https://example.com/ingest/register/';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"table_name":"example","title":"example","summary":"example","visibility":"private"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/ingest/register/ \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "table_name": "example", "title": "example", "summary": "example", "visibility": "private" }'Register an existing PostGIS table as a dataset.
Verifies the table exists, extracts metadata, and creates a catalog entry.
Authorizations
Section titled “ Authorizations ”Request Body required
Section titled “ Request Body required ”object
PostgreSQL table name in the data schema (max 63 chars per PostgreSQL identifier limit).
Human-readable dataset title shown in the catalog.
Dataset visibility level.
Responses
Section titled “ Responses ”Successful Response
object
Identifier of the newly registered dataset.
Title of the registered dataset.
Source PostgreSQL table that was registered.
Example generated
{ "dataset_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "title": "example", "table_name": "example"}Bad request — invalid payload
Unauthorized — missing or invalid credentials
Forbidden — caller lacks write access
Not found
Conflict — resource state prevents the operation
Validation error
Too many requests — retry after the advertised interval
Headers
Section titled “ Headers ”Seconds until the request may be retried
Internal server error
Service unavailable — the database could not serve the request