# Key terms

The vocabulary used across the Katonic developer documentation, grouped by concept.

The developer documentation uses the same vocabulary as the platform and the help centre. When a term below appears in an API field name it is written in code style; in prose it is written as shown here.

## Zones

| Term | Meaning |
| --- | --- |
| Work Room | Where people use agents and knowledge: chat, conversations, agents, apps, automations, artifacts. |
| Studio | Where builders create agents, prompts, skills and models. |
| Control Room | Where administrators govern and operate the platform. |
| Catalog | Where users discover pre-built agents, skills and apps. |

## Roles and grants

| Term | Meaning |
| --- | --- |
| Member | Base role. Uses the Work Room and the Catalog. |
| Builder | Adds Studio. Builds and publishes agents and knowledge. |
| Admin | Holds everything in the tenant except deciding who else holds admin roles. |
| Super Admin | Manages roles and the tenant itself. |
| Grant | One slice of Admin handed to a role that is not Admin. |

## Agents and knowledge

| Term | Meaning |
| --- | --- |
| Agent | A published assistant with its own instructions, knowledge, tools and model. |
| Knowledge source | A connected system or an upload whose content agents answer from; the unit Studio and the Control Room manage. |
| Ingestion | Reading, chunking and indexing content from a source. |
| Artifact | A file an agent produced, kept in the Work Room. |
| Automation | A workflow run on a schedule or trigger that can pause for approval. |

## API

| Term | Meaning |
| --- | --- |
| API key | A tenant-scoped credential that starts with `kapi_` and is sent as a bearer token. |
| Public API gateway | The single entry point for the public REST API. |
| Scope | A permission carried by an API key, chosen when the key is created; a route needs the scope shown on its reference page. |
| Endpoint group | One of the ten areas the reference and the Developer Hub sort endpoints into. |
| Rate limit | The per-minute and per-day request allowance of a key, reported in the `X-RateLimit-*` headers. |
| MCP | Model Context Protocol, an open standard for exposing tools and resources to AI hosts. |
| Katonic MCP Server | The platform's own MCP server, at `/mcp` on your tenant host, which turns public API calls into tools. |
| Katonic CLI | The `katonic-admin` command for operators: air-gap bundles and platform updates, not public API calls. |

## Terms that changed

Names that a reader may still hold from an earlier release, an older script or a tenant that has not been remapped. The old names are shown in code style because they are strings that may still sit in a configuration file or a realm, not words to write in prose.

| You may have | Write, and use, this now |
| --- | --- |
| `Workroom`, `WorkRoom` | Work Room |
| `Marketplace` | Catalog |
| `Viewer` role | Member |
| `Operator` role | Builder, plus the Operator grant |
| `Release Manager` role | Builder, plus the Release Approver grant |
| `Analytics Viewer`, `Audit Log Viewer`, `Agent Governance` grants | Auditor grant |
| `Guardrails Admin`, `Security Admin` grants | Security grant |
| `Infra Operator`, `Inference Optimizer` grants | Operator grant |
| `Model Risk Viewer` grant | Model Risk Approver grant |
| `Flywheel Engineer`, `Tools Admin` grants | The Builder role itself; tool policy moved to Admin |
| `pip install katonic` | An older SDK from a previous generation of the product, unrelated to today's CLI. See [Katonic CLI](/developers/libraries/cli) |
| `katonic-sdk` 6.x | The legacy MLOps SDK under the same package name. Today's Python SDK is 7.x: `pip install "katonic-sdk>=7"`. See [The Python SDK](/developers/libraries/python-sdk) |

A retired role name still resolves: the platform expands it to the current roles it now means, so an account carrying one keeps working until a Super Admin uses **Move retired roles** in the Control Room. Write the current name in anything new.

Two spellings reach the same field on the sessions routes: `agentId` and `agent_id`, `chatId` and `chat_id`. Both are accepted; the reference shows the spelling the route declares.

Source: https://docs.katonic.ai/developers/key-terms
