- Badges are explained under Approvals.
project_idis optional on most tools; without it, the server picks a project for that call only (Projects).expected_organization_idis an optional string on every write tool, omitted from parameter tables; passorganization.idfromget_identity(Organization check).limitvalues above a tool’s maximum are capped, not refused.
Tools
list_tags
List a project’s tags. Lists every tag with itstag_ ID, usage by kind, and the updatedAt that rename_tag and delete_tag need. One call returns all of them (at most 500).
Read-only · CLI: oqoqo tags list
Result fields
Each tag has
id, name, usage (total and byKind), createdAt, and updatedAt.
inspect_catalog and list_experiments filter by tag with tags and untagged.
update_tags
Add or remove tags on records. Adds and removes tags on up to 100 records at once. Adding a name that the project doesn’t have yet creates the tag. Changes data · CLI:oqoqo tags add, oqoqo tags remove
Result fields
records (each record’s id, kind, and all its tags after the change) and createdTags (the tags this call created).
You can send the same call again safely. A change that would give a record more than 20 tags changes nothing and returns tag_limit_exceeded. Tags never change a record’s definition, versions, or updatedAt.
rename_tag
Rename a tag. Renames a tag. Every record keeps it, because itstag_ ID doesn’t change.
Changes data · CLI: oqoqo tags rename
Result fields
The renamed
tag, with its id, name, usage, createdAt, and updatedAt.
A tag that changed since you read it returns tag_changed with the current updatedAt. A name that another tag in the project has, in any case, returns tag_name_taken with that tag’s ID.
delete_tag
Delete a tag from every record. Deletes a tag and removes it from every record that has it. Tell the person how many records have it, fromlist_tags, before you call it.
Destructive · Irreversible · CLI: oqoqo tags delete
Result fields
tag (the deleted tag’s id and name) and removedFrom (how many records had it). A tag the project doesn’t have returns tag_not_found.
inspect_data_model
List the data you can query. Lists every dataset, its fields and types, each field’s filters and aggregates, the default order, and the limits. Read-only · CLI:oqoqo data describe
Result fields
datasets, each with name, title, description, grain, fields, identityFields, defaultSelect, and defaultOrder, and limits. Each field has name, type, nullable, description, filterOperators, and aggregates.
query_data
Query Oqoqo data. Runs one bounded query over a dataset. It never accepts SQL or returns internal IDs, secrets, or credential-like values. Read-only · CLI:oqoqo data query
Queries run with a 3-second statement timeout and cap each returned cell at 4,096 bytes.
Result fields
columns, rows, query (the query as Oqoqo ran it), page (returned, hasMore, nextCursor, truncated, and reasons), and limits. The datasets and their fields are listed under oqoqo data, including evals.mode, the model fields of evals and insights, and the per-turn runTurns series.
Related
oqoqo tags
The matching tag CLI commands.
oqoqo data
All queryable datasets, fields, and query limits.

