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. |