> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonce.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Concepts

> Key terminology and concepts in Nonce

## Core Concepts

<Info>
  This page is a work in progress. More concepts and details will be added.
</Info>

### Workspace

A workspace is the top-level organizational unit in Nonce. It contains all your farms, miners, and configurations.

* Each workspace has a unique `workspace_id` (format: `org_xxxxxxxxxxxxxxxxxxxxxxxxxxx`)
* API keys are scoped to a specific workspace

### Farm

A farm represents a physical or logical grouping of miners.

* Each farm has a unique `farm_id` (UUID format)
* Farms belong to a single workspace
* Metrics and tasks are organized at the farm level

### Miner

A miner represents an individual mining device.

* Each miner has a unique `miner_id`
* Miners belong to a single farm
* Miner data includes hashrate, power consumption, temperature, and status ...

### Agent

An agent is a software component that communicates between your mining hardware and the Nonce platform.

* Agents are registered to a farm
* Each agent can manage multiple miners in specific farm

### Task

A task represents an operation to be performed on one or more miners.

* Tasks can be created individually or in batches
* Common task types include log collection, power mode changes, and pool updates

<Card title="Tasks Documentation" icon="list-check" href="/api-guide/tasks">
  Learn more about task types, parameters, and statuses
</Card>

### Actor

<Note>
  **Beta**: This feature is currently in beta.
</Note>

An actor represents an entity that performs actions in the system. Actors are used to track who created or modified resources.

* Three actor types: `user`, `apikey`, and `system`
* Used in audit trails and task batch tracking

<Card title="Actor Documentation" icon="user" href="/api-guide/actor">
  Learn more about actors and action tracking
</Card>

***

## Common Parameters

### Pagination

Most list endpoints support pagination:

| Parameter  | Type   | Description                              |
| ---------- | ------ | ---------------------------------------- |
| `page`     | number | Page number (default: 1)                 |
| `pageSize` | number | Items per page (default: 10, max: 10000) |