2025.26 Public API/SDK changes — Unique AI Documentation

2025.26 Public API/SDK changes

Public API

New Endpoints

Get Folder Info
Get the information of a folder based on the folder path or id. This can also be used to check whether a folder exists or not.

Example

GET by Id

curl --location --request GET '<https://gateway.<your-app>>.unique.app/public/chat/folder/info?scopeId=scope_jhsgdf7393bd83ewwer' \
--header 'x-user-id: <your-user-id>' \
--header 'x-company-id: <your-company-id>' \
--header 'Authorization: <your-api-key>' \
--header 'x-app-id: <your-app-id>' \
--header 'x-api-version: 2023-12-06' \
--header 'Content-Type: application/json' \

GET by Folder Path

curl --location --request GET '<https://gateway.<your-app>>.unique.app/public/chat/folder/info?folderPath=%2FCompany%2FClients%2FPortofolio' \
--header 'x-user-id: <your-user-id>' \
--header 'x-company-id: <your-company-id>' \
--header 'Authorization: <your-api-key>' \
--header 'x-app-id: <your-app-id>' \
--header 'x-api-version: 2023-12-06' \
--header 'Content-Type: application/json' \

Add Access to Folder Based on Path
Add access for a user or a group of users to a folder based on the path. Previously, this could only be done using the id.

Set applyToSubScope to true if you want to propagate the change to the sub scopes (default is false).
Use either the path of the folder you want to update (folderPath) or the id of the folder (scopeId). If both are provided, the scopeId will take precedence.

Example

curl --location --request PATCH '<https://gateway.<your-app>>.unique.app/public/chat/folder/add-access' \
--header 'x-user-id: <your-user-id>' \
--header 'x-company-id: <your-company-id>' \
--header 'Authorization: <your-api-key>' \
--header 'x-app-id: <your-app-id>' \
--header 'x-api-version: 2023-12-06' \
--header 'Content-Type: application/json' \
--data '{
    "folderPath": "Company/Clients/Portofolio", # use either folderPath or scopeId
    "scopeId": "scope_jhsgdf7393bd83ewwer, # use either folderPath or scopeId
    "scopeAccesses": [\
        {\
            "entityId": "group_f1pj8i73nbs7c1yl9yjtlwc8",\
            "entityType": "GROUP",\
            "type": "WRITE"\
        }\
    ],
    "applyToSubScopes": true
}'

Remove Access from Folder Based on Path
Remove access for a user or a group of users from a folder based on the path. Previously, this could only be done using the id.

Example

curl --location --request PATCH '<https://gateway.<your-app>>.unique.app/public/chat/folder/remove-access' \
--header 'x-user-id: <your-user-id>' \
--header 'x-company-id: <your-company-id>' \
--header 'Authorization: <your-api-key>' \
--header 'x-app-id: <your-app-id>' \
--header 'x-api-version: 2023-12-06' \
--header 'Content-Type: application/json' \
--data '{
    "folderPath": "Company/Clients/Portofolio", # use either folderPath or scopeId
    "scopeId": "scope_jhsgdf7393bd83ewwer, # use either folderPath or scopeId
    "scopeAccesses": [\
        {\
            "entityId": "group_f1pj8i73nbs7c1yl9yjtlwc8",\
            "entityType": "GROUP",\
            "type": "WRITE"\
        }\
    ],
    "applyToSubScopes": true
}'

Update the Ingestion Config of a Folder Based on Path
Update the ingestion config of a folder based on the path. Previously, this could only be done using the id.

Example

curl --location --request PATCH '<https://gateway.<your-app>>.unique.app/public/folder/ingestion-config' \
--header 'x-user-id: <your-user-id>' \
--header 'x-company-id: <your-company-id>' \
--header 'Authorization: <your-api-key>' \
--header 'x-app-id: <your-app-id>' \
--header 'x-api-version: 2023-12-06' \
--header 'Content-Type: application/json' \
--data '{
    "folderPath": "Company/Clients/Portofolio", # use either folderPath or scopeId
    "scopeId": "scope_jhsgdf7393bd83ewwer, # use either folderPath or scopeId
    "ingestionConfig": {
        "chunkMaxTokens": 1000,
        "chunkMaxTokensOnePager": 500,
        "chunkMinTokens": 100
    },
    "applyToSubScopes": true
}'

The updates above are also available in the SDK. Check out Unique SDK on PyPI: https://pypi.org/project/unique_sdk/ .