Jump to

• Request
• Response
• Examples

Get analysis details

get

/api/20210901/catalog/analysis/{urlBase64AnalysisId}

Return details of an existing analysis with the given id. For example, details such as owner, name, description, id, last modfied date, object type, and parent id. Analysis 'content' is also returned if the 'content' is requested via the query parameter 'fields'.

Request

Path Parameters

• urlBase64AnalysisId(required): string
  Analysis id with Base64URL encoding. For example, if you have an analysis with id '/myuser/samplefolder/samplesales', enter the Base64URL encoded value 'L215dXNlci9zYW1wbGVmb2xkZXIvc2FtcGxlc2FsZXM='.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation.

Body ()

Root Schema : schema

Type: object

400 Response

Invalid analysis encoded id

Body ()

Root Schema : 400BadRequest

Bad Request (invalid query parameters, malformed headers, and so on).

403 Response

Not authorized to view analysis

Body ()

Root Schema : 403Forbidden

Forbidden (missing permissions for operation, request denied for unspecified reason, and so on).

500 Response

Internal Server Error. The server encountered an unexpected condition preventing fulfilment of the request.

Body ()

Root Schema : Error

Type: object

Show Source

• code(required): string
  Short error code that defines the error, meant for programmatic parsing.
• message(required): string
  Human-readable error string.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

Back to Top

Examples

These examples show you how to return the details of an analysis with a given ID.

• Example 1 - No field criteria
• Example 2 - Multiple field criteria

Example 1 - No field criteria

In this example, you return the details of an existing analysis with the given ID without specifying fields to return. Listing no fields returns all details except for content. The object ID of the analysis is '/shared/Sales/Sales Analysis' which has the Base64URL-safe encoded ID value: L3NoYXJlZC9TYWxlcy9TYWxlcyBBbmFseXNpcw. You can get the ID of an analysis by using Get catalog items by type.

cURL Example:

curl    --header 'Authorization: Bearer <token>'    \
         --request GET 'https://<hostname>/api/20210901/catalog/analysis/L3NoYXJlZC9TYWxlcy9TYWxlcyBBbmFseXNpcw'

Example of Request Body

Not applicable.

Example of Response Body

{   
    "owner": "smith",    
    "name": "/shared/Sales/Sales Analysis",
    "description": "Sales Analysis",
    "id": "L3NoYXJlZC9TYWxlcy9TYWxlcyBBbmFseXNpcw",
    "last modified": "2025-01-01T19:53:07Z",
    "type": "analyses",
    "parent": "L3NoYXJlZC9TYWxlcy8",
}

Example 2 - Multiple field criteria

In this example, you return the details of an existing analysis with the given ID. Which details are returned is determined by listed fields after ?fields=, in this case the analysis name, description, and content details. The object ID of the analysis is '/shared/Sales/Sales Analysis' which has the Base64URL-safe encoded ID value: L3NoYXJlZC9TYWxlcy9TYWxlcyBBbmFseXNpcw.

cURL Example:

curl    --header 'Authorization: Bearer <token>'    \
         --request GET 'https://<hostname>/api/20210901/catalog/analysis/L3NoYXJlZC9TYWxlcy9TYWxlcyBBbmFseXNpcw?fields=name,description,content'

Example of Request Body

Not applicable.

Example of Response Body

{
    "name": "shared/Sales/Sales Analysis",
    "description": "Sales Analysis",    
    "content": "<analysis-xml-string>"
}

Back to Top