About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
Introduction
Last updated: 2024-08-05
A Unity REST Catalog refers to an API-based implementation that acts as a central metadata management service, often associated with distributed data processing and data lake architectures. It provides a unified interface to manage and query metadata for different data assets like databases, tables, schemas, and files stored across multiple storage systems.
The api are in beta state and expected to change.
Authentication
Required Purpose: To work with the API, you must use an IBM Cloud Identity and Access Management (IAM) access token or IAM API key. The token or API key is used to determine the actions that a user or service ID has access to when they use the API.
You can generate an IAM token for an authenticated user or service ID by using the IAM Identity Services API. IAM tokens are generated by using the user or service ID's API key. For more information, see Generating an IBM Cloud IAM token by using an API key.
To use the API, add a valid IAM token to the HTTP Authorization request header, for example, -H 'Authorization: Bearer {TOKEN}'.
To retrieve your access token:
curl -X POST "https://iam.cloud.ibm.com/identity/token" --header 'Content-Type: application/x-www-form-urlencoded' --header 'Accept: application/json' --data-urlencode 'grant_type=urn:ibm:params:oauth:grant-type:apikey' --data-urlencode 'apikey={API_KEY}'
Replace {API_KEY} with your IAM API key.
Error handling
This API uses standard HTTP response codes to indicate whether a method completed successfully. A 200 response indicates success. A 400 type response indicates a failure, and a 500 type response indicates an internal system error.
| HTTP Error Code | Description | Recovery |
|---|---|---|
200 |
Success | The request was successful. |
400 |
Bad Request | The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request. |
401 |
Unauthorized | You are not authorized to make this request. Log in to IBM Cloud and try again. If this error persists, contact the account owner to check your permissions. |
403 |
Forbidden | The supplied authentication is not authorized to access '{namespace}'. |
404 |
Not Found | The requested resource could not be found. |
409 |
Conflict | The entity is already in the requested state. |
500 |
Internal Server Error | Your request could not be processed. Wait a few minutes and try again. |
Methods
Request
Create catalog
Examples:
{
"name": "catalog1",
"comment": "My new Catalog",
"properties": {
"storageName": "ibm_bucket",
"catalogType": "iceberg"
}
}Name of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$A map of key-value properties attached to the securable.
User-provided free-form text description.
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d '{"name":"catalog1" ,"comment":"My new Catalog" ,"properties": {"storageName":"ibm_bucket" ,"catalogType":"iceberg" } }' "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/catalogs"
Response
Catalog Info
Name of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$A map of key-value properties attached to the securable.
Username of current owner of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this catalog was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of catalog creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this catalog was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9-_]*$
Status Code
The new catalog was successfully created.
Bad Request
Unauthorized
Example responses
{ "name": "catalog1", "comment": "My new Catalog", "properties": { "storageName": "ibm_bucket", "catalogType": "iceberg" }, "created_at": 1747292330, "updated_at": 0, "id": "0b8c015a-46f8-4778-8092-da84f9553100", "owner": "admin", "created_by": "admin", "updated_by": "null" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
List catalogs
Lists the available catalogs. There is no guarantee of a specific ordering of the elements in the list.
GET /catalogs
Request
Query Parameters
Opaque pagination token to go to next page based on previous query.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Maximum number of catalogs to return.
- when set to a value greater than 0, the page length is the minimum of this value and a server configured value;
- when set to 0, the page length is set to a server configured value;
- when set to a value less than 0, an invalid parameter error is returned;
Possible values: 0 ≤ value ≤ 1000000
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/catalogs"
Response
List of catalogs
An array of catalog information objects.
Possible values: 0 ≤ number of items ≤ 1000000000
Opaque token to retrieve the next page of results. Absent if there are no more pages. page_token should be set to this value for the next request (for the next page of results).
Possible values: 1 ≤ length ≤ 2000000, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The catalog list was successfully retrieved.
Bad Request
Unauthorized
Example responses
{ "catalogs": [ { "name": "catalog1", "comment": "", "properties": { "catalogType": "iceberg", "storageName": "ibm_bucket" }, "created_at": 1747298641, "updated_at": 0, "id": "da351865-e55c-48fd-bced-a75b674dd6a8", "owner": "admin", "created_by": "admin", "updated_by": null } ] }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
The name of the catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/catalogs/catalog1"
Response
Catalog Info
Name of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$A map of key-value properties attached to the securable.
Username of current owner of catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this catalog was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of catalog creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this catalog was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9-_]*$
Status Code
The catalog was successfully retrieved.
Bad Request
Unauthorized
Example responses
{ "name": "catalog1", "comment": "", "properties": { "catalogType": "iceberg", "storageName": "ibm_bucket" }, "created_at": 1747298641, "updated_at": 0, "id": "da351865-e55c-48fd-bced-a75b674dd6a8", "owner": "admin", "created_by": "admin", "updated_by": null }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
The name of the catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Query Parameters
Force deletion even if the catalog is not empty.
curl -X DELETE -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/catalogs/catalog1?force=true"
Response
Delete Catalog Response
Status Code
The catalog was successfully deleted.
Bad Request
Unauthorized
Example responses
catalog: catalog1 deleted successfully
{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Create a Schema
Name of schema, relative to parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Name of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$A map of key-value properties attached to the securable.
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d '{"name": "schema1", "catalog_name": "catalog1","comment": "My new schema","properties": { "locationUri": "s3a://ibm_bucket/schema1.db"}}' "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/schemas"
Response
Information about Schema
Name of schema, relative to parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Name of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$A map of key-value properties attached to the securable.
Full name of schema, in form of catalog_name.schema_name.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_.]*$Username of current owner of schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Time at which this schema was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of schema creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this schema was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$New name for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The new schema was successfully created.
Bad Request
Unauthorized
Example responses
{ "name": "schema1", "catalog_name": "catalog1", "comment": "My new Schema", "properties": { "locationUri": "s3a://ibm_bucket/schema1.db" }, "full_name": "catalog1.schema1", "created_at": 1747298641, "updated_at": 0, "schema_id": "2" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
List schemas
Gets an array of schemas for a catalog. There is no guarantee of a specific ordering of the elements in the array.
GET /schemas
Request
Query Parameters
Parent catalog for schemas of interest.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
catalog1Maximum number of schemas to return.
- when set to a value greater than 0, the page length is the minimum of this value and a server configured value;
- when set to 0, the page length is set to a server configured value;
- when set to a value less than 0, an invalid parameter error is returned;
Possible values: 0 ≤ value ≤ 1000000000000000
Opaque pagination token to go to next page based on previous query.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/schemas?catalog_name=catalog1"
Response
List Schema Response
An array of schema information objects.
Possible values: 0 ≤ number of items ≤ 250
Opaque token to retrieve the next page of results. Absent if there are no more pages. page_token should be set to this value for the next request (for the next page of results).
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The schemas list was successfully retrieved.
Bad Request
Unauthorized
Example responses
{ "schemas": [ { "name": "schema1", "catalog_name": "catalog1", "comment": "My new Schema", "properties": { "locationUri": "s3a://ibm_bucket/schema1.db" }, "full_name": "catalog1.schema1", "created_at": 1747298641, "updated_at": 0, "schema_id": "2" } ] }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
Full name of the schema.
Possible values: 1 ≤ length ≤ 256, Value must match regular expression
^[a-zA-Z0-9.-_]*$Example:
catalog1.schema1
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/schemas/catalog1.schema1"
Response
Information about Schema
Name of schema, relative to parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Name of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$A map of key-value properties attached to the securable.
Full name of schema, in form of catalog_name.schema_name.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_.]*$Username of current owner of schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Time at which this schema was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of schema creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this schema was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$New name for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The schema was successfully retrieved.
Bad Request
Unauthorized
Example responses
{ "name": "schema1", "catalog_name": "catalog1", "comment": "My new Schema", "properties": { "locationUri": "s3a://ibm_bucket/schema1.db" }, "full_name": "catalog1.schema1", "created_at": 1747298641, "updated_at": 0, "schema_id": "2" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
Full name of the schema.
Possible values: 1 ≤ length ≤ 256, Value must match regular expression
^[a-zA-Z0-9.-_]*$Example:
catalog1.schema1
Update Schema
User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$A map of key-value properties attached to the securable.
New name for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X PATCH -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d "comment": "new comment for schema schema_updated", "properties": { "locationUri": "s3a://ibm_bucket/schema_updated"},"new_name": "schema_updated" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/schemas/catalog1.schema1"
Response
Information about Schema
Name of schema, relative to parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Name of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$A map of key-value properties attached to the securable.
Full name of schema, in form of catalog_name.schema_name.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_.]*$Username of current owner of schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9_ ]*$Time at which this schema was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of schema creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Time at which this schema was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Unique identifier for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$New name for the schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The schema was successfully updated.
Bad Request
Unauthorized
Example responses
{ "name": "schema_updated", "catalog_name": "catalog2", "comment": "new comment for schema schema_updated", "properties": { "locationUri": "s3a://ibm_bucket/schema_updated" }, "full_name": "catalog2.schema_updated", "created_at": 1747323154589, "updated_at": 1747323154589, "schema_id": null }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
Full name of the schema.
Possible values: 1 ≤ length ≤ 256, Value must match regular expression
^[a-zA-Z0-9.-_]*$Example:
catalog1.schema1
Query Parameters
Force deletion even if the catalog is not empty.
curl -X DELETE -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/schemas/catalog1.schema1"
Response
Status Code
The schema was successfully deleted.
Bad Request
Unauthorized
Example responses
true{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Create a table
Name of table, relative to parent schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Name of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Name of parent schema relative to its parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Table Type
Allowable values: [
MANAGED,EXTERNAL]Data source format
Allowable values: [
CSV,JSON,AVRO,PARQUET,ORC,TEXT,ICEBERG,HIVE,HUDI,DELTA]The array of ColumnInfo definitions of the table's columns.
Possible values: 0 ≤ number of items ≤ 250
Storage root URL for external table
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$A map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d "{" "name": "table1", "catalog_name": "catalog1", "schema_name": "schema1", "table_type": "EXTERNAL", "data_source_format": "iceberg", "columns": [{ "name": "id", "type_text": "string", "type_json": "string", "type_name": "BOOLEAN", "type_precision": 0, "type_scale": 0, "type_interval_type": "string", "position": 0, "comment": "string", "nullable": true, "partition_index": 0 }], "storage_location": "s3a://mdsbucket/path1/path3/path5/presto-warehouse/ad_hive_schema/my_table_ad", "comment": "a new table", "properties": { "additionalProp1": "string" } }" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/tables"
Response
Table Info
The array of ColumnInfo definitions of the table's columns.
Possible values: 0 ≤ number of items ≤ 250
Name of table, relative to parent schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 _]*$Example:
stringName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringName of parent schema relative to its parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 _]*$Example:
stringTable Type
Possible values: [
MANAGED,EXTERNAL]Data source format
Possible values: [
CSV,JSON,AVRO,PARQUET,ORC,TEXT,ICEBERG,HIVE,HUDI,DELTA]Storage root URL for table (for MANAGED, EXTERNAL tables)
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*://[A-Za-z0-9-]{3,63}(?:.[A-Za-z0-9-]{3,63})*(/[A-Za-z0-9-_/]+)*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Username of current owner of table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this table was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of table creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this table was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified the table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringUnique identifier for the table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
Status Code
The new external table was successfully created.
Bad Request
Unauthorized
Example responses
{ "name": "table1", "columns": [ { "name": "id", "position": 0, "comment": "string", "nullable": false, "type_text": "string", "type_json": "string", "type_name": "STRING", "type_precision": 0, "type_scale": 0, "type_interval_type": null, "partition_index": 1 } ], "comment": null, "properties": { "additionalProp1": "string", "data_source_format": "iceberg" }, "catalog_name": "catalog1", "schema_name": "schema1", "table_type": "EXTERNAL", "data_source_format": "ICEBERG", "storage_location": "s3a://mdsbucket/path1/path3/path5/presto-warehouse/ad_hive_schema/my_table_ad", "created_at": 1748523046000, "updated_at": 0, "table_id": "0" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
List tables
Gets the list of all available tables under the parent catalog and schema. There is no guarantee of a specific ordering of the elements in the array.
GET /tables
Request
Query Parameters
Name of parent catalog for tables of interest.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Parent schema of tables.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Maximum number of tables to return.
- when set to a value greater than 0, the page length is the minimum of this value and a server configured value;
- when set to 0, the page length is set to a server configured value;
- when set to a value less than 0, an invalid parameter error is returned;
Possible values: 0 ≤ value ≤ 1000000000000000
Opaque token to send for the next page of results (pagination).
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/tables?catalog_name=catalog1&schema_name=schema1"
Response
List of Tables
An array of table information objects.
Possible values: 0 ≤ number of items ≤ 10000
Opaque token to retrieve the next page of results. Absent if there are no more pages. page_token should be set to this value for the next request (for the next page of results).
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
Status Code
The tables list was successfully retrieved.
Bad Request
Unauthorized
Example responses
{ "tables": [ { "name": "table1", "columns": [ { "name": "id", "position": 0, "comment": null, "nullable": false, "type_text": "string", "type_json": "string", "type_name": "STRING", "type_precision": 0, "type_scale": 0, "type_interval_type": null, "partition_index": 1 } ], "comment": null, "properties": { "additionalProp1": "string", "EXTERNAL": "TRUE", "write.parquet.compression-codec": "zstd", "transient_lastDdlTime": "1748523116", "current-schema": "{\"type\":\"struct\",\"schema-id\":0,\"fields\":[{\"id\":1,\"name\":\"id\",\"required\":false,\"type\":\"string\"}]}", "metadata_location": "s3a://mdsbucket/path1/path3/path5/presto-warehouse/ad_hive_schema/my_table_ad/metadata/00000-80f513a8-c5ad-4fc7-9e94-fe6582eba710.metadata.json", "snapshot-count": "0", "data_source_format": "iceberg", "uuid": "6091a98b-4391-4489-9f19-1f7de8dcd3fa", "table_type": "ICEBERG" }, "catalog_name": "catalog1", "schema_name": "schema1", "table_type": "EXTERNAL", "data_source_format": "ICEBERG", "storage_location": "s3a://mdsbucket/path1/path3/path5/presto-warehouse/ad_hive_schema/my_table_ad", "created_at": 1748523067000, "updated_at": 0, "table_id": "21" } ] }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Path Parameters
Full name of the table.
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X GET -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/tables/catalog1.schema1.table1"
Response
Table Info
The array of ColumnInfo definitions of the table's columns.
Possible values: 0 ≤ number of items ≤ 250
Name of table, relative to parent schema.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 _]*$Example:
stringName of parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringName of parent schema relative to its parent catalog.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 _]*$Example:
stringTable Type
Possible values: [
MANAGED,EXTERNAL]Data source format
Possible values: [
CSV,JSON,AVRO,PARQUET,ORC,TEXT,ICEBERG,HIVE,HUDI,DELTA]Storage root URL for table (for MANAGED, EXTERNAL tables)
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*://[A-Za-z0-9-]{3,63}(?:.[A-Za-z0-9-]{3,63})*(/[A-Za-z0-9-_/]+)*$User-provided free-form text description.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringA map of key-value properties attached to the securable.
- properties
Additional properties
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$
Username of current owner of table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this table was created, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of table creator.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringTime at which this table was last modified, in epoch milliseconds.
Possible values: 0 ≤ value ≤ 1000000000000000
Username of user who last modified the table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
stringUnique identifier for the table.
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9]*$Example:
string
Status Code
The table was successfully retrieved.
Bad Request
Unauthorized
Example responses
{ "name": "table1", "columns": [ { "name": "id", "position": 0, "comment": "", "nullable": false, "type_text": "string", "type_json": "string", "type_name": "STRING", "type_precision": 0, "type_scale": 0, "type_interval_type": null, "partition_index": 1 } ], "comment": null, "properties": { "EXTERNAL": "TRUE", "additionalProp1": "string", "write.parquet.compression-codec": "zstd", "metadata_location": "s3a://mdsbucket/path1/path3/path5/presto-warehouse/ad_hive_schema/my_table_ad/metadata/00000-80f513a8-c5ad-4fc7-9e94-fe6582eba710.metadata.json", "current-schema": "{\"type\":\"struct\",\"schema-id\":0,\"fields\":[{\"id\":1,\"name\":\"id\",\"required\":false,\"type\":\"string\"}]}", "transient_lastDdlTime": "1748523116", "data_source_format": "iceberg", "snapshot-count": "0", "uuid": "6091a98b-4391-4489-9f19-1f7de8dcd3fa", "table_type": "ICEBERG" }, "catalog_name": "catalog1", "schema_name": "schema1", "table_type": "EXTERNAL", "data_source_format": "ICEBERG", "storage_location": "s3a://mdsbucket/path1/path3/path5/presto-warehouse/ad_hive_schema/my_table_ad", "created_at": 1748523067000, "updated_at": 0, "table_id": "21" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Delete a table
Deletes a table from the specified parent catalog and schema.
DELETE /tables/{full_name}Request
Path Parameters
Full name of the table.
Possible values: 1 ≤ length ≤ 100000, Value must match regular expression
^[a-zA-Z0-9]*$
curl -X DELETE -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/tables/catalog1.schema1.table1"
Response
Status Code
The table was successfully deleted.
Bad Request
Unauthorized
Example responses
true{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Examples:
{
"operation": "READ",
"table_id": "10"
}Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Allowable values: [
UNKNOWN_TABLE_OPERATION,READ,READ_WRITE]
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d '{"table_id":"10","operation":"UNKNOWN_TABLE_OPERATION"}' "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/temporary-table-credentials"
Response
Response for credential APIs
Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 0 ≤ value ≤ 1000000000000000
Status Code
OK
Bad Request
Unauthorized
Example responses
{ "aws_temp_credentials": { "access_key_id": "dummy access key id", "secret_access_key": "dummy secret access key", "session_token": "dummy session token" }, "azure_user_delegation_sas": null, "gcp_oauth_token": null, "expiration_time": null }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
Request
Get a temporary Path credential
Examples:
{
"url": "abfss://pyspark@sparkadlsiae.dfs.core.windows.net",
"operation": "PATH_CREATE_TABLE"
}url
Possible values: 1 ≤ length ≤ 128, Value must match regular expression
^[a-zA-Z0-9 ]*$Operation
Allowable values: [
UNKNOWN_PATH_OPERATION,PATH_READ,PATH_READ_WRITE,PATH_CREATE_TABLE]
curl -X POST -H "accept: application/json" -H "Authorization: ••••••" -H "Content-Type: application/json" -d '{"url":"abfss://pyspark@sparkadlsiae.blob.core.windows.net/","operation":"PATH_CREATE_TABLE"}' "https://fe4e6892-2f92-4e74-a262-f8f1f30d57a5.cfjag3sf0s5o87astjo0.lakehouse.dev.appdomain.cloud:32600/api/2.1/unity-catalog/temporary-path-credentials"
Response
Response for credential APIs
Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 1 ≤ length ≤ 1000000, Value must match regular expression
^[a-zA-Z0-9 ]*$Possible values: 0 ≤ value ≤ 1000000000000000
Status Code
OK
Bad Request
Unauthorized
Example responses
{ "aws_temp_credentials": null, "azure_user_delegation_sas": { "sas_token": "sv=2025-01-05&st=2025-05-29T10%3A57%3A54Z&se=2025-05-29T11%3A57%3A54Z&skoid=bc71c096-2f7d-4b2c-afcc-721e0b3446b9&sktid=0d909434-4142-4034-8b85-691ead3660b6&skt=2025-05-29T10%3A57%3A54Z&ske=2025-05-29T11%3A57%3A54Z&sks=b&skv=2025-01-05&sr=c&sp=rwdl&sig=nsXKg5MbflTGnCeOEA3LzXZhUwmCF0CTML7qTMgLb9g%3D" }, "gcp_oauth_token": null, "expiration_time": 1748519874234 }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }{ "error": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "exception": { "cause": { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "suppressed": [ { "stackTrace": [ { "classLoaderName": "string", "moduleName": "string", "moduleVersion": "string", "methodName": "string", "fileName": "string", "lineNumber": 0, "nativeMethod": true, "className": "string" } ], "message": "string", "localizedMessage": "string" } ], "localizedMessage": "string" }, "message_code": "string", "status_code": 0, "message": "string" }
id=curlclassName=tab-item-selected