1Get AI Spaces

Overview

This API retrieves the complete list of AI Spaces, along with their associated folders from the root directory.

Method: GET

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

sessionid

String

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

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

–

Query Parameters

Parameter Name	Type	Description	Possible Values

Parameter Name	Type	Description	Possible Values
show	String	Specifies the objects to be returned in the response.	all – Returns both folders and AI Spaces. list – Returns only AI Spaces. folders – Returns only folders. Default: `all`
owner	String	Filters AI Spaces by the owner name (the user who created the AI Space).	–
tags	String	Filters AI Spaces by tag. This filter applies only to AI Spaces with a single tag.	–
searchText	String	Filters AI Spaces whose names contain the specified text (case-insensitive).	–
modifiedAfter	Number	Returns AI Spaces modified after the specified Unix timestamp.	–
modifiedBefore	Number	Returns AI Spaces modified before the specified Unix timestamp.	–
count	Number	Limits the number of records returned. Applicable only when show=list or show=folders. Note: If a negative value is specified, all available records are returned. Default: `500`	–
lastEntityName	String	Returns entities occurring after the specified entity name.	–
lastEntityId	String	Returns entities occurring after the specified entity ID.	–

Responses

200 Success

{
  "folders": [
    {
      "owner": "kyvos",
      "name": "AI Space",
      "id": "folder_17761562996322127015027151277115",
      "lastModified": "04/17/2026 17:47:20 IST",
      "accessRights": "1",
      "ownerId": "28727"
    },
    {
      "owner": "Admin",
      "name": "Sales",
      "id": "folder_17775370656938127040023168551975",
      "lastModified": "04/30/2026 13:47:45 IST",
      "accessRights": "1",
      "ownerId": "392064895"
    }
  ],
  "spaces": [
    {
      "owner": "automationclient",
      "name": "EmptySpace",
      "id": "123456788",
      "lastModified": "05/16/2026 03:57:04 IST",
      "accessRights": "1",
      "ownerId": "337708002",
      "lastModifiedTimestamp": "1778884024515"
    },
    {
      "owner": "Admin",
      "name": "Joining_and_Blending102",
      "id": "17778909497047127047080179960940102",
      "lastModified": "06/02/2026 17:25:56 IST",
      "accessRights": "1",
      "ownerId": "402343863",
      "lastModifiedTimestamp": "1780401356088"
    }
  ]
}

Status Code	Description

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