1Import AI Space Verified Queries

1Import AI Space Verified Queries

Overview

This API imports a CSV file of verified queries and updates the corresponding AI Space using the data provided. Each entry may include a Natural Language Query, SQL Query, Context, associated Users, Groups, and Suggested Query.

Method: POST

Request URL: {kyvos-url}/rest/v2/ai-spaces/{name-or-id}/import-verified-queries


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

Content-Type (Required)

String

Specifies media type of request body.

multipart/form-data

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 AI Space on which natural language queries need to be imported.

Note: If the AI Space name is provided, then folderName 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 an AI Space name or AI Space ID.

If by=name, provide the AI Space name in the name-or-id parameter.

If by=id, provide the AI Space ID in the name-or-id parameter.

The default value is name.

–

folderName

String

Name of the folder containing the AI Space. If the AI Space is present in the root directory, specify [Root].

Note: If folderName is not provided, the AI Space will be treated as a root-level entity by default.

–


Request Body

Parameter Name

Type

Description

Possible Values

Parameter Name

Type

Description

Possible Values

file (Required)

String

Select the CSV file downloaded using the Export AI Space Verified Queries API.

–

lineSeparator

String

Characters for line separator.

–

fieldSeparator

String

Delimiter to be used for each field.

–

enclosedBy

String

Characters to be used for enclosing data.

–


Responses

200 Success

Success

Status Code

Description

Status Code

Description

401

Authorization information is missing or invalid.

404

No matching record found.

412

Precondition failed. Parameter missing.

500

Internal Server Error

Copyright Kyvos, Inc. 2026. All rights reserved.