# 2025.52 Public API / SDK Changes

## Public API

### **New Endpoints**

tech **POST Create Space** \- API to create a new space (assistant).

**Body**

- `name` (required) - The name of the space  
- `fallbackModule` (required) - The fallback module name (must match one of the module names)  
- `modules` (required) - List of modules to create for the space  
  - `name` (required) - The name of the module  
  - `description` (optional) - The description of the module  
  - `weight` (optional) - The weight/priority of the module  
  - `isExternal` (optional) - Whether the module is external  
  - `isCustomInstructionEnabled` (optional) - Whether custom instruction is enabled  
  - `configuration` (optional) - Configuration for the module  
  - `toolDefinition` (optional) - Tool definition for the module  
  - `explanation` (optional) - Description of the space  
  - `alert` (optional) - Alert message for the space  
  - `chatUpload` (optional) - Chat upload setting (`ENABLED` \| `DISABLED`)  
  - `languageModel` (optional) - Language model to use  
  - `isExternal` (optional) - Whether the space is external  
  - `isPinned` (optional) - Whether the space is pinned  
  - `uiType` (optional) - UI type (`MAGIC_TABLE` \| `UNIQUE_CUSTOM` \| `TRANSLATION` \| `UNIQUE_AI`)  
  - `settings` (optional) - Space settings

**Example**

```
curl --location --request POST 'https://api.uat1.unique.app/v1/space' \  
--header 'x-user-id: <user-id>' \  
--header 'x-company-id: <company-id>' \  
--header 'Authorization: Bearer <api-key>' \  
--header 'x-app-id: <app-id>' \  
--header 'x-api-version: 2023-12-06' \  
--header 'Content-Type: application/json' \  
--data-raw '{  
  "name": "Customer Support Assistant",  
  "fallbackModule": "UniqueAi",  
  "modules": [\  
    {\  
      "name": "UniqueAi",\  
      "weight": 10000\  
    }\  
  ]  
}'
```

tech **GET Get Space Access** \- API to retrieve access entries for a space. Requires manage access to the space.

**Path Params**

- `spaceId` (required) - The ID of the space

**Example**

```
curl --location --request GET 'https://api.uat1.unique.app/v1/space/<space-id>/access' \  
--header 'x-user-id: <user-id>' \  
--header 'x-company-id: <company-id>' \  
--header 'Authorization: Bearer <api-key>' \  
--header 'x-app-id: <app-id>' \  
--header 'x-api-version: 2023-12-06' \  
--header 'Content-Type: application/json'
```

tech **POST Add Space Access** \- API to add access entries to a space. Requires manage access to the space.

**Path Params**

- `spaceId` (required) - The ID of the space

**Request Body**

- `accessIds` (required) - List of access entries to add  
- `entityId` (required) - The ID of the entity (user or group)  
- `entityType` (required) - The type of entity (`USER` \| `GROUP`)  
- `type` (required) - The type of access (`USE` \| `MANAGE` \| `UPLOAD`)

**Example**

```
curl --location --request POST 'https://api.uat1.unique.app/v1/space/<space-id>/access' \  
--header 'x-user-id: <user-id>' \  
--header 'x-company-id: <company-id>' \  
--header 'Authorization: Bearer <api-key>' \  
--header 'x-app-id: <app-id>' \  
--header 'x-api-version: 2023-12-06' \  
--header 'Content-Type: application/json' \  
--data-raw '{  
  "accessIds": [\  
    {\  
      "entityId": "228959553377538182",\  
      "entityType": "USER",\  
      "type": "USE"\  
    }\  
  ]  
}'
```

tech **DELETE Delete Space Access** \- API to remove access entries from a space. Requires manage access to the space.

**Path Params**

- `spaceId` (required) - The ID of the space

**Request Body**

- `accessIds` (required) - List of access entry IDs to delete

**Example**

```
curl --location --request DELETE 'https://api.uat1.unique.app/v1/space/<space-id>/access' \  
--header 'x-user-id: <user-id>' \  
--header 'x-company-id: <company-id>' \  
--header 'Authorization: Bearer <api-key>' \  
--header 'x-app-id: <app-id>' \  
--header 'x-api-version: 2023-12-06' \  
--header 'Content-Type: application/json' \  
--data-raw '{  
  "accessIds": ["access_yptvsdq8sqjfsxe1ih0mnug7"]
}'
```

tech **GET Get User Groups** \- API to retrieve groups that a specific user belongs to.

**Path Params**

- `userId` (required) - The ID of the user

**Example**

```
curl --location --request GET 'https://api.uat1.unique.app/v1/users/<user-id>/groups' \  
--header 'x-user-id: <user-id>' \  
--header 'x-company-id: <company-id>' \  
--header 'Authorization: Bearer <api-key>' \  
--header 'x-app-id: <app-id>' \  
--header 'x-api-version: 2023-12-06' \  
--header 'Content-Type: application/json'
```

### Updated Endpoints

tech **GET Get Users** \- Added support for filtering users by userName.

**Query Params**

- `skip` (optional) - Number of records to skip for pagination (minimum: 0)  
- `take` (optional) - Number of records to retrieve (minimum: 1, maximum: 1000)  
- `email` (optional) - Filter users by email address  
- `displayName` (optional) - Filter users by display name  
- `userName` (optional) - Filter users by user name _(new)_

**Example**

```
curl --location --request GET 'https://api.uat1.unique.app/v1/users?skip=0&take=100&userName=john.doe' \  
--header 'x-user-id: <user-id>' \  
--header 'x-company-id: <company-id>' \  
--header 'Authorization: Bearer <api-key>' \  
--header 'x-app-id: <app-id>' \  
--header 'x-api-version: 2023-12-06' \  
--header 'Content-Type: application/json'
```

tech **POST Content Upsert** \- Added support for `hideInChat` in `ingestionConfig` to control content visibility in chat.

**Request Body**

- `input.ingestionConfig.hideInChat` (optional) - Boolean flag to hide content from chat view. When set to `true`, the content will be filtered out when retrieving content for a chat. Defaults to `false`.

**Example**

```
curl --location --request POST 'https://api.uat1.unique.app/v1/content/upsert' \  
--header 'x-user-id: <user-id>' \  
--header 'x-company-id: <company-id>' \  
--header 'Authorization: Bearer <api-key>' \  
--header 'x-app-id: <app-id>' \  
--header 'x-api-version: 2023-12-06' \  
--header 'Content-Type: application/json' \  
--data-raw '{  
  "input": {  
    "key": "document-key",  
    "title": "My Document",  
    "mimeType": "application/pdf",  
    "ingestionConfig": {  
      "hideInChat": true  
    }  
  },  
  "chatId": "<chat-id>"  
}'
```

## SDK

### **New Functions**

tech **Create Space** \- Create a new space (assistant) with specified configuration including modules, name, and settings.

**Example**

```
space = unique_sdk.Space.create_space(
    user_id=user_id,
    company_id=company_id,
    name="Customer Support Assistant",
    fallbackModule="UniqueAi",
    modules=[\
        {\
            "name": "UniqueAi",\
            "weight": 10000,\
            "description": "Main AI module for customer support",\
            "isExternal": False,\
            "isCustomInstructionEnabled": True,\
            "configuration": {},\
            "toolDefinition": None,\
        }\
    ],
    explanation="AI assistant for handling customer inquiries",
    alert="Please note: This assistant may not have access to real-time data",
    chatUpload="ENABLED",
    languageModel="GPT-4o",
    isExternal=False,
    isPinned=True,
    uiType="UNIQUE_AI",
)
```

tech **Get Space Access** \- Retrieve access entries for a space. Requires manage access to the space.

**Example**

```
access = unique_sdk.Space.get_space_access(
    user_id=user_id,
    company_id=company_id,
    space_id="assistant_hjcdga64bkcjnhu4",
)
```

tech **Add Space Access** \- Add access entries (users or groups) to a space with USE, MANAGE, or UPLOAD permissions.

**Example**

```
result = unique_sdk.Space.add_space_access(
    user_id=user_id,
    company_id=company_id,
    space_id="assistant_hjcdga64bkcjnhu4",
    accessIds=[{"entityId": "228959553377538182", "entityType": "USER", "type": "USE"}]
)
```

tech **Delete Space Access**\- Remove access entries from a space by access entry IDs.

**Example**

```
result = unique_sdk.Space.delete_space_access(
    user_id=user_id,
    company_id=company_id,
    space_id="assistant_hjcdga64bkcjnhu4",
    accessIds=["access_yptvsdq8sqjfsxe1ih0mnug7"]
)
```

tech **Get User Groups** \- Retrieve all groups that a specific user belongs to.

**Example**

```
user_groups = unique_sdk.User.get_user_groups(
    user_id=user_id,
    company_id=company_id,
    target_user_id="351283829975023795",
)
```

### **Updated Functions**

tech **Get Users** \- Added userName filter to search users by username.

**Example**

```
users = unique_sdk.User.get_users(
    user_id=user_id,
    company_id=company_id,
    userName="john.doe",
)
```

tech **Content Upsert** \- Added `hideInChat` parameter in `ingestionConfig` to control content visibility in chat.

**Example**

```
content = unique_sdk.Content.upsert(
    user_id=user_id,
    company_id=company_id,
    input={
        "key": "document-key",
        "title": "My Document",
        "mimeType": "application/pdf",
        "ingestionConfig": {
            "hideInChat": True
        }
    },
    chatId="<chat-id>",
)
```