arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

deleteSubjects

This method is to delete one or more subjects.

triangle-exclamation

Deleting a subject is irreversible. There is no way to recover a deleted subject.

This method was added in Cortex 2.1

hashtag
Parameters

A subject is identified by his/her name, so you must provide the name of the subjects you want to delete.

hashtag
Result

The result is an object that includes these fields:

In case of success, you get an object with these fields:

In case of failure, you get an object with these fields:

hashtag
Examples

.

Name

Type

Required

Description

cortexToken

string

yes

A token returned by .

subjects

array of strings

yes

A list a subject names.

Name

Type

Description

success

array of objects

For each subject you successfully deleted, this array contains an object with the name of deleted subject.

failure

array of objects

For each subject you failed to delete, this array contains an object that describes the error.

Name

Type

Description

subjectName

string

The name of the deleted subject.

Name

Type

Description

subjectName

string

The name of the subject.

code

number

The error code.

message

string

The error message.

{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "deleteSubjects",
    "params": {
        "cortexToken": "xxx",
        "subjects": ["Invalid Name", "Bob Smith"]
    }
}
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "failure": [
            {
                "code": -32124,
                "message": "The subject was not found.",
                "subjectName": "Invalid Name"
            }
        ],
        "success": [
            {
                "subjectName": "Bob Smith"
            }
        ]
    }
}
authorize