# Glossary

The terms these docs use, each defined in one sentence and linked to the page that explains it.

| Term | Definition | Explained in |
| --- | --- | --- |
| Space | The boundary for permissions and paths, within which members, roles, and the file tree are kept, with one default Space per account. | [Core concepts](https://mirabase.io/developers/concepts.md#space) |
| Entry | The stable identity of a source, such as a file, a URL, or a piece of text. | [Core concepts](https://mirabase.io/developers/concepts.md#entry-version) |
| Version | An immutable record of an Entry's content, made each time the content changes. | [Core concepts](https://mirabase.io/developers/concepts.md#entry-version) |
| Knowledge state | The processing progress of an Entry, reported in `knowledge.state`. | [Core concepts](https://mirabase.io/developers/concepts.md#knowledge) |
| Memory | A statement with a scope, a status, and a source, which is an account memory, a memory written as an Entry, or a fact distilled from an Entry. | [Memory](https://mirabase.io/developers/memory.md#model) |
| Memory scope | What a memory belongs to: `project` is one Space, `agent` is one Agent, and `account` is the account. | [Memory](https://mirabase.io/developers/memory.md#model) |
| Memory status | Where a memory stands in review: `candidate`, `confirmed`, `rejected`, or `superseded`. | [Memory](https://mirabase.io/developers/memory.md#model) |
| Principal | The person (`kind: human`) or Agent (`kind: agent`) a request acts as; an API key belongs to a principal and is not one itself. | [Permissions](https://mirabase.io/developers/permissions.md#principals) |
| Capability | Permission for one kind of operation, such as `knowledge:read` or `knowledge:write`. | [Permissions](https://mirabase.io/developers/permissions.md#capabilities) |
| API key | The credential sent on every request as `Authorization: Bearer mb_live_...`, which can only narrow its principal. | [Authentication and API keys](https://mirabase.io/developers/authentication.md#bearer) |
| Agent | A principal of `kind: agent`, with its own permissions, memory, and audit identity. | [Permissions](https://mirabase.io/developers/permissions.md#principals) |
| Context pack | What `context` returns for a task: sources the service picked and packed within a token budget, with its choices explained in `route`. | [Retrieval and context](https://mirabase.io/developers/retrieval.md#context) |
| Citation | The `[cN]` id of one source in a context pack, which an answer uses to mark where a statement comes from. | [Retrieval and context](https://mirabase.io/developers/retrieval.md#answer) |
| Branch | A copy-on-write layer over a Space's main line, used as an Agent's workspace, whose paths become versions on main only when merged. | [Branches and mounts](https://mirabase.io/developers/branches.md#branches) |
| Checkpoint | A record of a branch's own changes at one moment, which the branch can roll back to. | [Branches and mounts](https://mirabase.io/developers/branches.md#checkpoints) |
| Snapshot | A record of every file's path and version in a Space at one moment, which copies no bytes. | [Sync, snapshots, and export](https://mirabase.io/developers/sync.md#snapshots) |
| Proposal | A write an Agent submits for a file owned by someone else, which becomes a new version only when a reviewer approves it. | [Files and versions](https://mirabase.io/developers/files.md#proposals) |
| Job | Work that cannot finish within the request, which returns 202 with a `job_id` that you poll until the status is final. | [API conventions](https://mirabase.io/developers/conventions.md#jobs) |
| Read root | The `read_root` the Space owner sets on a member, which limits reads to that directory and returns 404 for paths outside it. | [Permissions](https://mirabase.io/developers/permissions.md#roots) |
| Write root | The `write_root` the Space owner sets on a member, which limits writes to that directory. | [Permissions](https://mirabase.io/developers/permissions.md#roots) |
| Idempotency key | The `Idempotency-Key` header on a write, which lets you send the write again without running it twice. | [API conventions](https://mirabase.io/developers/conventions.md#idempotency) |
| Cursor | An opaque string a list or the change feed returns, used to read the next page or continue. | [API conventions](https://mirabase.io/developers/conventions.md#pagination) |
| ETag | The id of a file's latest version, used for conditional writes and reads. | [API conventions](https://mirabase.io/developers/conventions.md#conditional) |
| Offline consolidation | An optional deployment feature that tidies existing memories while no Agent is working, without generating new content; each run is called a dream in the API. | [Memory](https://mirabase.io/developers/memory.md#dreams) |

## Next steps

- [Files and versions](https://mirabase.io/developers/files.md): start by writing a file.
- [Permissions](https://mirabase.io/developers/permissions.md): how principals, capabilities, roles, and roots decide a request.
- [API reference](https://mirabase.io/developers/api.md): the parameters and responses of every endpoint.
