1Deep Delete Semantic Model

Overview

This API permanently deletes a Semantic Model along with all its associated source entities.

Method: DELETE

Request URL: {kyvos-url}/rest/v2/semantic-models/{name-or-id}/deep-delete

Authorization

API Key: `sessionid`

This method authenticates requests using a session ID which acts like an API key.

BasicAuth: HTTP Authorization Scheme

This method authenticates requests using a username and password sent in the HTTP Authorization header.

Headers

Header Name	Type	Description	Possible Values

Header Name

Type

Description

Possible Values

sessionid

String

The session ID is the token received from the login API.

Note: Session ID is required for token-based authentication.

–

Path Parameters

Parameter Name	Type	Description	Possible Values

Parameter Name

Type

Description

Possible Values

name-or-id (Required)

String

Name or ID of the Semantic Model to be deleted, including all associated source entities.

Note: If the Semantic Model name is provided, either folderName or folderId must also be provided.

–

Query Parameters

Parameter Name	Type	Description	Possible Values

Parameter Name	Type	Description	Possible Values
by	String	Specifies whether the name-or-id parameter should be interpreted as a Semantic Model name or Semantic Model ID. If by=name, provide the Semantic Model name in the name-or-id parameter. If by=id, provide the Semantic Model ID in the name-or-id parameter. The default value is name.	–
folderName	String	Name of the folder containing the Semantic Model. If the Semantic Model is present in the root directory, specify [Root]. Note: If neither folderId nor folderName is provided, the Semantic Model will be treated as a root-level entity by default.	–
folderId	String	ID of the folder containing the Semantic Model.	–
deleteSharedSourceEntities	Boolean	Controls whether shared source entities should also be deleted.	true – Deletes all source entities, including Datasets and Dataset Relationships, even if they are shared with other entities. false – Deletes only source entities (Datasets and Dataset Relationships) that are not shared with other entities. Default: `true`

Responses

200 Success

{
    "code":0,
    "semanticModels":[
        {
            "code":"0",
            "name":"Sales Semantic Model",
            "id":"17806377765173127094028130591664",
            "folderName":"Sales",
            "message":"Deleted successfully.",
            "folderId":"folder_17778916258243127088097114950635",
            "status":"DELETED"
        }
    ],
    "datasets":[
        {
            "code":"0",
            "name":"Sales Dataset",
            "id":"17778956085863127034012164369951",
            "folderName":"Sales",
            "message":"Deleted successfully.",
            "folderId":"",
            "status":"DELETED"
        }
    ],
    "datasetRelationships":[
        {
            "code":"0",
            "rootCause":"",
            "name":"Sales Relationship",
            "id":"17778957138273127092014186744841",
            "folderName":"Sales",
            "message":"Deleted successfully.",
            "folderId":"folder_17778916410524127097089181743972",
            "status":"DELETED"
        }
    ],
    "message":"Deep delete execution completed."
}

207 Multi-Status

{
    "code":32220,
    "semanticModels":[
        {
            "code":"0",
            "name":"Sales Semantic Model",
            "id":"SMODEL_OBJECT_17853939145400127013025148311824",
            "folderName":"Sales",
            "message":"Deleted successfully.",
            "folderId":"folder_17853190873819127066080196170972",
            "status":"DELETED"
        }
    ],
    "message":"Deep delete execution completed.",
    "datasetRelationships":[
        {
            "code":"32220",
            "rootCause":"No matching record found",
            "name":"",
            "id":"17853938278657127024049146575227",
            "folderName":"",
            "message":"DATASET_RELATIONSHIP '17853938278657127024049146575227' not found in folder ''.",
            "folderId":"",
            "status":"ERROR"
        }
    ]
}

Status Code	Description

Status Code	Description
401	Authorization information is missing or invalid.
404	No matching record found.
500	Internal Server Error