ID format
Most public IDs are a prefix that names the kind of record, an underscore, and 24 lowercase hexadecimal characters, such asexp_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
- Run scope flags take
exp_,sch_,tsk_,tskver_,trt_,skl_,mcp_,cli_,sdk_,sklver_,mcpver_,cliver_,sdkver_,fld_,env_,agm_, andfrc_. - Tags go on
tsk_,fld_,env_,skl_,mcp_,cli_,sdk_,trt_, andexp_.
Operation IDs
Oqoqo returns these for one operation, for you to send back. Their length varies.
A public experiment link has a
pub_ ID with 32 hexadecimal characters, shown by oqoqo experiments publications list and on Share results.
Keys
Some records have a key instead of an ID.
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).
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.
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
Product limits
Related
CLI reference
Global flags, output, exit codes, and conventions.
Plugin (MCP) reference
IDs, paging, and polling from your AI assistant.
Glossary
Every Oqoqo term in one place.
Run scope flags
Narrow runs and frictions by any record ID.

