2.2.1-Create Folder or Dataset In Knowledge Base

1. Overview

  • Interface Name: Create a folder or dataset

  • Version number: v1.0.0

2. Information

  • Request method: POST

  • Request URL: https://DOMAIN/openapi/v1/knowledge/folder/

  • Domain: Refer to "Service address description"

3. Request parameters

Request header http header field:

Parameter name
Type
Required
Description

Content-Type

string

Yes

Fixedapplication/json

cybertron-robot-key

string

Yes

Robot key

cybertron-robot-token

string

Yes

Robot token

Request body field:

Parameter name
Type
Required
Description

username

string

Yes

User account

parent_id

string

No

parent folder id

knowledge_base_id

string

Yes

Knowledge Base id

name

string

Yes

New folder or dataset name

folder_type

int

Yes

Folder type (1: Text dataset 2: QA dataset 3: Folder)

4. Response field description

HTTP status code: 200 OK

Response field description:

Field Name
Type
Description

code

string

"000000" is normal, other exceptions

message

string

Status description

data

array

message body

id

int

folder or dataset id

name

string

folder or dataset name

folder_type

string

folder type

parent_id

string

parent folder id

5. Example

Request Example:

curl 'https://_DOMAIN_/openapi/v1/knowledge/folder/' \
-H 'Content-Type: application/json' \
-H 'cybertron-robot-key: l8ia2IOc************Z724%2BU%3D' \
-H 'cybertron-robot-token: MTc0Mzk5************************************************cGRCUTg9' \
-X POST -d '{
    "username": "me@host.com",
    "parent_id": null,
    "knowledge_base_id": "5700",
    "name": "folder1",
    "folder_type": 3
}'

Response example:

{
    "code": "000000",
    "message": "Get Success",
    "data": {
        "id": 12966,
        "name": "folder1",
        "folder_type": 3,
        "parent_id": null
    }
}