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

# IDs and limits

> Look up what each Oqoqo ID prefix names and where you see it, and the product limits for paging, tags, schedules, launches, and runs.

## ID format

Most public IDs are a prefix that names the kind of record, an underscore, and 24 lowercase hexadecimal characters, such as `exp_4c19a7e2b05d3f8a61c2e9d0`. An ID never changes, even when you rename the record. Pass IDs exactly as Oqoqo returns them; these docs shorten them for readability, as in `exp_8f2c41d0`.

## Record IDs

| Prefix | Names | Where you see it |
| - | - | - |
| `prj_` | A project | Its dashboard address (`/projects/prj_…`), [`oqoqo projects list`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-list), [`oqoqo projects current`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-current), and `--project-id` |
| `tsk_` | A task, in every version | Task pages, [`oqoqo catalog list`](https://docs.oqoqo.ai/cli/catalog#oqoqo-catalog-list), and `--task-id` |
| `tskver_` | One version of a task | Catalog and run results, and `--task-version-id` |
| `fld_` | A file | **Manage → Files**, the catalog, and `--file-id` |
| `env_` | A machine | **Manage → Machines (Environments)**, the catalog, and `--machine-id` |
| `skl_` | A skill | **Manage → Tools**, the catalog, and `--tool-id` |
| `mcp_` | An MCP server | **Manage → Tools**, the catalog, [`oqoqo mcp accounts`](https://docs.oqoqo.ai/cli/agents-and-models#oqoqo-mcp-accounts-inspect), and `--tool-id` |
| `cli_` | A CLI | **Manage → Tools**, the catalog, and `--tool-id` |
| `sdk_` | An SDK | **Manage → Tools**, the catalog, and `--tool-id` |
| `sklver_`, `mcpver_`, `cliver_`, `sdkver_` | One version of a skill, MCP server, CLI, or SDK | Catalog results, and `--tool-version-id` |
| `trt_` | A treatment (toolset) | **Manage → Treatments (Toolsets)**, the catalog, and `--treatment-id` |
| `agm_` | One agent with one model | [`oqoqo catalog list --kind agent`](https://docs.oqoqo.ai/cli/catalog#oqoqo-catalog-list), launch plans, and `--agent-model-id` |
| `exp_` | An experiment | Experiment pages, [`oqoqo experiments list`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-list), and `--experiment-id` |
| `sch_` | A schedule | Schedule pages, [`oqoqo schedules list`](https://docs.oqoqo.ai/cli/schedules#oqoqo-schedules-list), and `--schedule-id` |
| `run_` | A run. Each trial is a run with its own `run_` ID. | [`oqoqo runs list`](https://docs.oqoqo.ai/cli/runs#oqoqo-runs-list), friction evidence, Evals and Insights results, and `--run-id` |
| `frc_` | A friction | Friction pages, [`oqoqo frictions list`](https://docs.oqoqo.ai/cli/frictions#oqoqo-frictions-list), and `--friction-id` |
| `cmp_` | One comparison in an experiment, kept when Evals run again | [`oqoqo evals compare`](https://docs.oqoqo.ai/cli/evals-and-insights#oqoqo-evals-compare), `--comparison`, and `comparison_id` |
| `brf_` | An experiment's written Brief | [`oqoqo experiments brief`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-brief) |
| `tag_` | A tag | [`oqoqo tags list`](https://docs.oqoqo.ai/cli/tags#oqoqo-tags-list) |
| `aic_` | A model provider connection | [`oqoqo project ai inspect --view providers`](https://docs.oqoqo.ai/cli/agents-and-models#oqoqo-project-ai-inspect) |
| `aim_` | A model on a provider connection | `oqoqo project ai inspect --view models`, and Evals and Insights model choices |
| `upl_` | An archive upload | [`oqoqo uploads create`](https://docs.oqoqo.ai/cli/catalog#oqoqo-uploads-create) and `oqoqo uploads get` |
| `qtx_` | One run balance transaction | [`oqoqo quota ledger`](https://docs.oqoqo.ai/cli/billing-and-notifications#oqoqo-quota-ledger) |
| `chat_` | One Ask Oqo chat | Ask Oqo, including editor chats through [`oqoqo acp`](https://docs.oqoqo.ai/cli/ask-oqo#oqoqo-acp) |

* [Run scope flags](https://docs.oqoqo.ai/cli/runs.md#run-scope-flags) take `exp_`, `sch_`, `tsk_`, `tskver_`, `trt_`, `skl_`, `mcp_`, `cli_`, `sdk_`, `sklver_`, `mcpver_`, `cliver_`, `sdkver_`, `fld_`, `env_`, `agm_`, and `frc_`.
* [Tags](https://docs.oqoqo.ai/cli/tags.md) go on `tsk_`, `fld_`, `env_`, `skl_`, `mcp_`, `cli_`, `sdk_`, `trt_`, and `exp_`.

## Operation IDs

Oqoqo returns these for one operation, for you to send back. Their length varies.

| Prefix | Names | Where you see it |
| - | - | - |
| `adm_` | A launch | [`oqoqo experiments launch`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-launch), `oqoqo experiments status` and `watch`, and Test agent runs |
| `del_` | A deletion | `oqoqo resources delete` and [`oqoqo deletions status`](https://docs.oqoqo.ai/cli/catalog#oqoqo-deletions-status) |
| `eval_` | An Evals attempt | [`oqoqo evals list`](https://docs.oqoqo.ai/cli/evals-and-insights#oqoqo-evals-list) and `oqoqo evals get` |
| `insights_` | An Insights attempt | [`oqoqo insights list`](https://docs.oqoqo.ai/cli/evals-and-insights#oqoqo-insights-list) and `oqoqo insights get` |

A public experiment link has a `pub_` ID with 32 hexadecimal characters, shown by [`oqoqo experiments publications list`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publications-list) and on [Share results](https://docs.oqoqo.ai/evaluation/share.md).

## Keys

Some records have a key instead of an ID.

| Key | Names | Example |
| - | - | - |
| Agent key | An agent with any model: a run's `agentId`, and what `--agent-id` takes | `claude-code` |
| Custom agent key | A [custom agent](https://docs.oqoqo.ai/setup/custom-agents.md) | `acp-0123456789abcdef` |
| Task key, skill key | A task or skill by its key, for filters such as `--task-key` | `checkout` |

Agent keys use lowercase letters, digits, and hyphens, never an underscore, so they never look like public IDs. Send a cursor (`nextCursor`) back exactly as you received it. An attempt ID (`--attempt-id`) is a string you choose; reuse it only to retry the same change ([CLI conventions](https://docs.oqoqo.ai/cli/overview.md#conventions)).

## Paging limits

A `--limit` (or the plugin's `limit`) above the maximum is capped, not refused. Responses are capped at 20 KiB, so a page can hold fewer items. Continue with `nextCursor` while `hasMore` is true.

| Command | Plugin (MCP) tool | Default | Maximum |
| - | - | - | - |
| [`oqoqo catalog list`](https://docs.oqoqo.ai/cli/catalog#oqoqo-catalog-list) | [`inspect_catalog`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#inspect_catalog) | 100 | 500 |
| `oqoqo resources inspect` | [`inspect_resource`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#inspect_resource) | 100 | 500 |
| [`oqoqo experiments list`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-list) | [`list_experiments`](https://docs.oqoqo.ai/mcp-server/experiments#list_experiments) | 50 | 200 |
| `oqoqo experiments publications list` | [`list_experiment_publications`](https://docs.oqoqo.ai/mcp-server/experiments#list_experiment_publications) | 50 | 200 |
| `oqoqo gallery get` | [`get_public_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#get_public_experiment) | 50 | 200 |
| [`oqoqo schedules list`](https://docs.oqoqo.ai/cli/schedules#oqoqo-schedules-list) | [`list_schedules`](https://docs.oqoqo.ai/mcp-server/schedules#list_schedules) | 50 | 200 |
| [`oqoqo runs list`](https://docs.oqoqo.ai/cli/runs#oqoqo-runs-list) | [`list_runs`](https://docs.oqoqo.ai/mcp-server/runs-and-results#list_runs) | 50 | 200 |
| [`oqoqo runs trajectory`](https://docs.oqoqo.ai/cli/runs#oqoqo-runs-trajectory) | [`get_run_trajectory`](https://docs.oqoqo.ai/mcp-server/runs-and-results#get_run_trajectory) | 100 steps | 500 steps |
| [`oqoqo frictions list`](https://docs.oqoqo.ai/cli/frictions#oqoqo-frictions-list) | [`list_frictions`](https://docs.oqoqo.ai/mcp-server/frictions#list_frictions) | 25 | 100 |
| [`oqoqo evals list`](https://docs.oqoqo.ai/cli/evals-and-insights#oqoqo-evals-list), `oqoqo insights list` | [`list_evals`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#list_evals), [`list_insights`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#list_insights) | 25 | 100 |
| [`oqoqo evals get`](https://docs.oqoqo.ai/cli/evals-and-insights#oqoqo-evals-get), `oqoqo insights get` | [`get_evals_results`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#get_evals_results), [`get_insights_results`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#get_insights_results) | 50 | 200 |
| [`oqoqo results analyze`](https://docs.oqoqo.ai/cli/runs#oqoqo-results-analyze) | [`analyze_results`](https://docs.oqoqo.ai/mcp-server/runs-and-results#analyze_results) | | 100 ranked items, not paged |
| [`oqoqo evals compare`](https://docs.oqoqo.ai/cli/evals-and-insights#oqoqo-evals-compare) | [`get_evals_comparisons`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#get_evals_comparisons) | 200 | 200 |
| [`oqoqo project ai inspect`](https://docs.oqoqo.ai/cli/agents-and-models#oqoqo-project-ai-inspect) | [`inspect_project_ai`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#inspect_project_ai) | 100 | 500 |
| [`oqoqo quota ledger`](https://docs.oqoqo.ai/cli/billing-and-notifications#oqoqo-quota-ledger) | [`list_quota_ledger`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#list_quota_ledger) | 50 | 100 |
| [`oqoqo notifications list`](https://docs.oqoqo.ai/cli/billing-and-notifications#oqoqo-notifications-list) | [`list_notifications`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#list_notifications) | 25 | 50 |
| [`oqoqo notifications acknowledge --all`](https://docs.oqoqo.ai/cli/billing-and-notifications#oqoqo-notifications-acknowledge) | [`acknowledge_notifications`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#acknowledge_notifications) | 500 | 500 |
| [`oqoqo data query`](https://docs.oqoqo.ai/cli/data#oqoqo-data-query) | [`query_data`](https://docs.oqoqo.ai/mcp-server/tags-and-data#query_data) | | 200 rows |
| `oqoqo github browse` | [`browse_github_source`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#browse_github_source) | Repositories 10, refs 100, paths 100 | Repositories 30, refs 200, paths 1,000 |

Comparisons page with the same `--kind` and `--label` (`kind` and `label` in the plugin), and a cursor is refused once the comparisons change.

## Content and wait limits

| Limit | Value | Where it applies |
| - | - | - |
| Bytes in one content page | 12,288 | [`oqoqo runs transcript`](https://docs.oqoqo.ai/cli/runs#oqoqo-runs-transcript), [`oqoqo runs output`](https://docs.oqoqo.ai/cli/runs#oqoqo-runs-output), the byte views of `oqoqo evals get` and `oqoqo insights get`, and `oqoqo resources inspect` and `archive`. Page by offset until `eof`. |
| Wait for a change (`--wait-ms`) | 25,000 ms | `oqoqo experiments status`, [`oqoqo evals get`](https://docs.oqoqo.ai/cli/evals-and-insights#oqoqo-evals-get), and `oqoqo insights get`. In the plugin, `wait_ms` on `get_launch_status`, `get_experiment_status`, `get_evals_results`, and `get_insights_results`. |
| Runs analyzed together (`--runs`) | 3 | [`oqoqo results analyze`](https://docs.oqoqo.ai/cli/runs#oqoqo-results-analyze) |

## Product limits

| Limit | Value | Details |
| - | - | - |
| Runs in one **Compare** | 3 | [Read results](https://docs.oqoqo.ai/evaluation/results.md) |
| Matrix cells (tasks × combinations) that **Comparisons** reads | 10,000. Larger returns `experiment_too_large` (**Too large to compare**). | [Comparisons](https://docs.oqoqo.ai/evaluation/comparisons.md) |
| Agents that **Comparisons** compares with each other | 6. With more, agents aren't compared with each other, and there's no **Does a treatment help one agent more?** | [Comparisons](https://docs.oqoqo.ai/evaluation/comparisons.md) |
| Differences in a **Brief** | 5, each with up to 3 frictions | [Brief](https://docs.oqoqo.ai/evaluation/comparisons.md#brief) |
| Trace size for one run | 32 MB. A larger trace isn't saved, so Evals and Insights can't read its steps; the run keeps its outcome. | [What Evals read](https://docs.oqoqo.ai/evaluation/evals.md#what-evals-read), [What Insights read](https://docs.oqoqo.ai/evaluation/insights.md#what-insights-read) |
| Tasks, treatments, or agents in one experiment | 100 each | [Launch an experiment](https://docs.oqoqo.ai/experiments/launch.md) |
| Trials in one experiment | 20 | [Launch an experiment](https://docs.oqoqo.ai/experiments/launch.md) |
| Runs in one experiment | 100,000 | [Launch an experiment](https://docs.oqoqo.ai/experiments/launch.md) |
| Skills, MCP servers, CLIs, or SDKs in one treatment of a launch | 100 each | [Launch an experiment](https://docs.oqoqo.ai/experiments/launch.md) |
| Active schedules in one project | 50 | [Schedules](https://docs.oqoqo.ai/experiments/schedules.md) |
| Schedule start times | On the quarter hour: the cron minute is 0, 15, 30, or 45 | [Schedules](https://docs.oqoqo.ai/experiments/schedules.md) |
| Schedule preview | The next 3 launches, and the runs of the next 30 days | [Schedules](https://docs.oqoqo.ai/experiments/schedules.md) |
| Operations in one `oqoqo resources bulk-apply` | 20 | [`oqoqo resources bulk-apply`](https://docs.oqoqo.ai/cli/catalog#oqoqo-resources-bulk-apply) |
| File or task import archive | 512 MiB, 512 MiB expanded, and 65,535 files and folders | [`oqoqo uploads create`](https://docs.oqoqo.ai/cli/catalog#oqoqo-uploads-create) |
| Skill archive | 256 MiB, 256 MiB expanded, and 65,535 files and folders | [`oqoqo uploads create`](https://docs.oqoqo.ai/cli/catalog#oqoqo-uploads-create) |
| Text file in a public experiment link | 256 KiB. Larger and binary files aren't shared. | [Share results](https://docs.oqoqo.ai/evaluation/share.md) |
| Tag name | 1 to 40 characters, with no comma | [Tags](https://docs.oqoqo.ai/experiments/tags.md) |
| Tags on one record | 20 | [Tags](https://docs.oqoqo.ai/experiments/tags.md) |
| Tags in one project | 500 | [Tags](https://docs.oqoqo.ai/experiments/tags.md) |
| Records in one tag change | 100 | [Tags](https://docs.oqoqo.ai/experiments/tags.md) |
| Tags named in one tag change or filter | 20 | [`oqoqo tags`](https://docs.oqoqo.ai/cli/tags#names-and-limits) |
| Custom agent name | 120 characters | [Custom agents](https://docs.oqoqo.ai/setup/custom-agents.md) |
| Models in one `set_models_enabled` or `set_model_context_windows` | 5,000 | [`oqoqo project ai apply`](https://docs.oqoqo.ai/cli/agents-and-models#oqoqo-project-ai-apply) |
| Connections in one `refresh_models` | 200 | [`oqoqo project ai apply`](https://docs.oqoqo.ai/cli/agents-and-models#oqoqo-project-ai-apply) |
| Runs in one `--requested-runs` check | 1,000,000 | [`oqoqo quota inspect`](https://docs.oqoqo.ai/cli/billing-and-notifications#oqoqo-quota-inspect) |
| Recent runs on a friction | 10 | [Frictions](https://docs.oqoqo.ai/evaluation/frictions.md) |

## Related

> [card] [CLI reference](https://docs.oqoqo.ai/cli/overview.md)
>
> Global flags, output, exit codes, and conventions.

> [card] [Plugin (MCP) reference](https://docs.oqoqo.ai/mcp-server/overview.md)
>
> IDs, paging, and polling from your AI assistant.

> [card] [Glossary](https://docs.oqoqo.ai/reference/glossary.md)
>
> Every Oqoqo term in one place.

> [card] [Run scope flags](https://docs.oqoqo.ai/cli/runs.md#run-scope-flags)
>
> Narrow runs and frictions by any record ID.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.