Create Custom View (RESERVED)

RESERVED: The keyword RESERVED annotation means that the API is available for use but is not yet part of the officially supported specification. Its behavior, interface, or output may change in future releases without backward compatibility guarantees.


Overview

Create a new custom aggregation view for organizing objects within an application. Custom views act as containers for custom nodes.

Only dynamic custom view creation is supported through this API.

URI

POST /rest/applications/{name}/custom-views

Path parameters

name (string)

This parameter identifies the analyzed application. The application name must be properly encoded if required. Character back-quote is not allowed.

Request Body

{
    "name": "My Custom View",
    "collaborators": [],
    "mode": "dynamic"
}

A JSON object describing the new custom view:

Property Type Required Description
name string Yes Name of the custom view.
collaborators []string No List of usernames who can collaborate on this view.
mode string No View mode. Default is dynamic.

Responses

application/json

Example:

{
    "success": {
        "id": "abc123-def456",
        "name": "My Custom View",
        "collaborators": [],
        "mode": "dynamic",
        "published": false,
        "isCreator": true,
        "createdBy": "admin",
        "createdAt": "2024-01-15T10:30:00"
    }
}

JSON representation

Property Type Description
success.id string The unique identifier for the created view.
success.name string The view name.
success.collaborators []string List of collaborator usernames.
success.mode string The created view mode. Successful creation returns dynamic.
success.published boolean Whether the view is published for sharing.
success.isCreator boolean Whether the current user is the creator.
success.createdBy string Username of the view creator.
success.createdAt string Timestamp when the view was created.