Get catalog item details

get

/api/20210901/catalog/{type}/{id}

Returns information about a catalog item with a given type and ID. For example, details such as owner, name, description, ID, last modified date, object type, and parent ID. If the item is a container item such as folder or dashboard, sub items can be searched using the search query parameter. Returned lists have a maximum of 10000 items. For information about the search syntax, see Search Options.

Request

Path Parameters
  • Catalog item ID in base64url format.
  • 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.
Query Parameters
  • Comma separated list of fields to exclude from response.
  • Comma separated list of fields to include in response.
  • Number of catalog items per page.
  • If true, search is performed in content management mode. You need Manage Content permission to enable content management mode.
  • Page number.
  • Search string.
  • Sort by criteria.
  • Sort order.
    Allowed Values: [ "ASC", "DESC" ]
  • 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 Top

Response

Supported Media Types

200 Response

Successful operation
Headers
Body ()
Root Schema : schema
Match One Schema
Show Source
Nested Schema : CatalogItem
Match All
Show Source
Nested Schema : CatalogFolderItem
Match All
Show Source
Nested Schema : CatalogItems
Type: array
Show Source
Nested Schema : Discriminator: type
Type: object
Show Source
Nested Schema : CatalogItemIdRef
Type: object
Show Source
Nested Schema : CatalogItemParentIdNameRef
Type: object
Show Source
Nested Schema : CatalogFolderItem-allOf[1]
Type: object
Show Source

400 Response

Bad Request (invalid query parameters, malformed headers, and so on).
Body ()
Root Schema : Error
Type: object
Show Source

401 Response

Unauthorized (missing or expired credentials, and so on).
Body ()
Root Schema : Error
Type: object
Show Source

403 Response

Forbidden (missing permissions for operation, request denied for unspecified reason, and so on).
Body ()
Root Schema : Error
Type: object
Show Source

404 Response

Not Found. The requested resource was not found.
Body ()
Root Schema : Error
Type: object
Show Source

500 Response

Internal Server Error. The server encountered an unexpected condition preventing fulfilment of the request.
Body ()
Root Schema : Error
Type: object
Show Source
Back to Top

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'
Back to Top