Create AI Space

Create AI Space

This documentation is for Kyvos 2026.6.x. To view documentation for other Kyvos versions, click here.

This documentation is for Kyvos 2026.6.x. To view documentation for other Kyvos versions, click here.

Overview

This API creates a new AI Space object using the details provided.

Method: POST

Request URL: {kyvos-url}/rest/v2/ai-spaces


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.

application/x-www-form-urlencoded

sessionid

String

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

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

–


Request Body

Parameter Name

Type

Description

Possible Values

Parameter Name

Type

Description

Possible Values

json (Required)

String

JSON containing details of the AI Space object to be created.

Note: An example JSON is provided under the Resources section below.

–


Responses

200 Success

{ "res": { "code": 0, "entityId": "", "message": "Successfully added space: NEW-SPACE 121", "extMessage": "" } }

Status Code

Description

Status Code

Description

401

Authorization information is missing or invalid.

404

No matching record found.

412

Precondition failed. Required parameter missing.

500

Internal Server Error


Resources

JSON Example for request body parameter.

Copyright Kyvos, Inc. 2026. All rights reserved.