Unique AI Documentation

2026.10 Public API / SDK Changes

1 min read

note

Heads Up – New API Version Coming Soon

We want to inform you that a new version of the Public API is currently in development. No action is required on your end at this time - we will provide full documentation and a clear adoption timeline ahead of any changes.

What's changing?

  • Enforced role-based access control (RBAC)

  • Stricter request validation

Stay tuned for more details soon.

Public API

New Endpoints

tech PATCH Update Space - API to update a space (assistant). Preserves the assistant_id so end users keep chat history. Requires Manage access to the space.

Path:

  • spaceId (required) – ID of the space (assistant) to update

Body:

  • name (optional) – Space name

  • title (optional) – Space title

  • explanation (optional) – Space description

  • alert (optional) – Alert message for the space

  • chatUpload (optional) – Valid values: ENABLED, DISABLED

  • languageModel (optional) – Language model (e.g. AZURE_GPT_4o_2024_0806); must be supported for the company

  • isPinned (optional) – Whether the space is pinned

  • settings (optional) – Space settings (object)

  • allowEndUserSpace (optional) – Whether end users can create spaces from this assistant

  • uiType (optional) – Valid values: MAGIC_TABLE, UNIQUE_CUSTOM, TRANSLATION, UNIQUE_AI. Use UNIQUE_AI for legacy migration

  • modules (optional) – Array of module updates by ID; each object: moduleId (required), configuration, name, description, weight

Example

curl --location --request PATCH 'https://api.uat1.unique.app/v1/public/space/<space-id>' \
--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 '{
  "name": "Customer Support Assistant",
  "uiType": "UNIQUE_AI"
}'

SDK

tech Update Space - Modify space properties including name, title, language model, and UI type without losing chat history. Supports module updates.

Example

space = unique_sdk.Space.update_space(
  user_id=user_id,
  company_id=company_id,
  space_id="assistant_abc123",
  name="Updated Space Name",
  title="Updated Title",
  languageModel="AZURE_GPT_4o_2024_0806",
  uiType="UNIQUE_AI", # Migrate from legacy
  isPinned=True,
)

Author

Last updated