Get catalog item details
/api/20210901/catalog/{type}/{id}
Request
-
id(required): string
Catalog item ID in base64url format.
-
type(required):
Type of catalog item. These content types are supported
- folders - Folders containing catalog objects.
- workbooks - Workbooks.
- subjectAreas - Subject areas.
- datasets - Datasets.
- connections - Objects containing connection details.
- dataflows - Data flows.
- models - Predictive and machine learning models.
- sequences - Sequences.
- analysis - Analyses.
- reports - Pixel-perfect reports (BIP reports).
- dashboards - Dashboards.
- dashboardpages - Dashboard pages.
- dashboardgroupfolders - Workbooks and dashboards available from the Navigation menu on the Home page.
- scripts - Custom scripts for machine learning and data curation.
-
excludedFields: string
Comma separated list of fields to exclude from response.
-
fields: string
Comma separated list of fields to include in response.
-
limit: integer
Number of catalog items per page.
-
manageContent: boolean
If true, search is performed in content management mode. You need Manage Content permission to enable content management mode.
-
page: integer
Page number.
-
search: string
Search string.
-
sortBy: string
Sort by criteria.
-
sortOrder: string
Sort order.Allowed Values:
[ "ASC", "DESC" ]
-
type:
Catalog item type filter. These content filter types are supported
- folders - Folders containing catalog objects.
- workbooks - Workbooks.
- subjectAreas - Subject areas.
- datasets - Datasets.
- connections - Objects containing connection details.
- dataflows - Data flows.
- models - Predictive and machine learning models.
- sequences - Sequences.
- analysis - Analyses.
- reports - Pixel-perfect reports (BIP reports).
- dashboards - Dashboards.
- dashboardpages - Dashboard pages.
- dashboardgroupfolders - Workbooks and dashboards available from the Navigation menu on the Home page.
- scripts - Custom scripts for machine learning and data curation.
There's no request body for this operation.
Back to TopResponse
- application/json
200 Response
-
object
CatalogItemIdRef
-
object
CatalogItemParentIdNameRef
-
object
Discriminator: type
Discriminator:
{ "propertyName":"type" }
object
-
description: string
Catalog item description, if any
-
lastModified: string
(date-time)
Catalog item last modified date and time
-
owner: string
Catalog item owner
-
type:
type
object
-
name: string
Catalog item name
-
parentId: string
Catalog parent item identifier (if catalog item has a parent)
400 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
401 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
403 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
404 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
500 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
Examples
cURL Example - No Search Criteria
This example shows you how to obtain details about a specific catalog object,
MySalesWorkbook
. The object type
value is
workbooks
. The object ID of the workbook is
/@Catalog/shared/Sales/MySalesWorkbook
which has the Base64URL-safe
encoded id
value
L0BDYXRhbG9nL3NoYXJlZC9TYWxlcy9NeVNhbGVzV29ya2Jvb2s
.
First, obtain the object ID of the workbook you want details for. Base64URL-safe encode the
value to determine the id
. You can obtain the Object ID value from
the Inspect dialog for the object in Oracle Analytics Cloud.
Run the cURL command with the required type
and id
:
curl -i --header 'Authorization: Bearer <token>' \ --request GET 'https://<hostname>/api/20210901/catalog/workbooks/L0BDYXRhbG9nL3NoYXJlZC9TYWxlcy9NeVNhbGVzV29ya2Jvb2s'
cURL Example - With Search Criteria
If the item is a container object (such as a folder or dashboard), you can use the search
query parameter to further refine the results of your search. This example returns all the
subitems in the shared/Sales
folder.
curl -i --header 'Authorization: Bearer <token>' \ --request GET 'https://<hostname>/api/20210901/catalog/folders/c2hhcmVkL1NhbGVz?search=*'
You can also narrow the search to only return items that contain a specific string. This
example returns all subitems in the shared/Sales
folder that contains
KPI
.
curl -i --header 'Authorization: Bearer <token>' \ --request GET 'https://<hostname>/api/20210901/catalog/folders/c2hhcmVkL1NhbGVz?search="KPI"'
Example of Request Body
Not applicable.
Example of Response Body
Status 200:
[ { "owner": "smith", "name": "MySalesWorkbook", "description": "My cool sales analytics", "id": "L0BDYXRhbG9nL3NoYXJlZC9TYWxlcy9NeVNhbGVzV29ya2Jvb2s", "lastModified": "2024-01-01T18:59:16Z", "type": "workbooks", "parentId": "L0BDYXRhbG9nL3NoYXJlZC9TYWxlcw" } ]
cURL Example - With manageContent Enabled
If you have the appropriate privileges, you can run search queries in content management
mode by setting the manageContent
parameter set to true
.
When you search in content management mode, the API can return items not owned by or shared
with you. You must have the Manage Content permission or BI Service Administrator role to
run the query in content management mode.
This example returns details for a workbook not owned by or shared with you. The workbook
has the object ID /@Catalog/shared/Sales/MySalesWorkbook
and the
Base64URL-safe encoded id
value
L0BDYXRhbG9nL3NoYXJlZC9TYWxlcy9NeVNhbGVzV29ya2Jvb2s
.
curl -i --header 'Authorization: Bearer <token>' \ --request GET 'https://<hostname>/api/20210901/catalog/workbooks/L0BDYXRhbG9nL3NoYXJlZC9TYWxlcy9NeVNhbGVzV29ya2Jvb2s?manageContent=true'