ImportOS · Docs
Desk

Settings

Profile, API keys, extension code, integrations; brand, team, stages, tariffs, templates, billing.

Available Route in Desk: /settings

What works now

Sub-sectionWhat it doesState
Profilename, interface language (uk, pl, en), theme (light, dark, system)Available
API keyscreate, one-time reveal and revoke keys for the Data API and MCPAvailable owner only
Extensiona one-time connection code for the Margin extensionBeta the code is issued, the extension does not accept it yet
Integrationswhat works live and what in demo mode, which variables are neededAvailable view only

Profile

The theme is stored in this browser. A super-admin without a company changes the language only in the browser.

API keys

This is the sub-section needed for the developer scenario: API quick start. Only a company owner can create keys.

  1. Open "Settings → API keys".
  2. Enter a name (for example "MCP for Claude").
  3. Choose scopes: read:pricing for turnkey calculation and rules; read:listings for Scout listings and VIN; mcp to connect an MCP client; write:deals to create and update deals and contacts (reserved for future endpoints).
  4. Choose an expiry: none or a number of days.
  5. Press "Create key". The key is shown once: copy it right away, only a hash is stored.
  6. The list shows status (active, revoked, expired), creation date and last use. "Revoke" stops access immediately and irreversibly.
Creating an API key in Desk
Creating an API key in Desk · Placeholder screenshot: to be replaced with a real capture

Extension

A side feature for the future binding of the extension to a company: "Generate code" creates a one-time code for 10 minutes. The current extension version calculates locally and does not wire up the code exchange yet.

Integrations

A table of platform integrations: FX rates, VIN, container tracking, payment providers, storage, Nova Poshta, maps. For each the mode (live, test, demo) and the missing environment variables (in yellow) are shown. Key values are never shown. The full catalog: Integrations.

What is coming

In development: tenant settings sub-sections

  • Brand: logo, colors, tracking domain (Track). - Team and roles: inviting employees and distributing permissions. Accepting an invitation comes with the team service. - Deal stages: enabling and disabling, SLA, names for the client (stages). - Tariffs: service tariffs (fee model) and logistics tariffs for the calculator. - Message templates: texts for Telegram, Viber, SMS and email. - Company connections: Telegram bot, payment provider, ShipsGo, Google Sheets export. Management (view only now). - ImportOS subscription billing: plan, invoices, payment.

On this page