Skip to main content
Organize resources and experiments with tags, or run bounded JSON queries over your results datasets.
  • Badges are explained under Approvals.
  • project_id is optional on most tools; without it, the server picks a project for that call only (Projects).
  • expected_organization_id is an optional string on every write tool, omitted from parameter tables; pass organization.id from get_identity (Organization check).
  • limit values above a tool’s maximum are capped, not refused.

Tools

list_tags

List a project’s tags. Lists every tag with its tag_ 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 its tag_ 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, from list_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.

oqoqo tags

The matching tag CLI commands.

oqoqo data

All queryable datasets, fields, and query limits.