tag_ ID that helps you find records again. It never changes what a record does or how a run uses it.
Refer to tags and records
Name a tag by itstag_ ID or by its name in any case (Flaky and flaky are the same tag). Quote a name with spaces. Name a record by its public ID:
Tags go on the record, not a version, so new versions keep them. Agents, runs, frictions, and projects have no tags.
oqoqo tags list
List the project’s tags, with each one’stag_ ID and how many records of each kind have it.
list_tags
Flags
Also takes the global flags.
Examples
List the project’s tags:
oqoqo tags add
Add tags to up to 100 records at once. A new name creates the tag.update_tags
Arguments
Flags
Also takes the global flags.
Examples
Tag a task and an experiment:
Notes
You can run the command again safely: a record that already has a tag keeps it. A change that goes over a limit changes nothing and fails with
tag_limit_exceeded, which names the limit.
oqoqo tags remove
Remove tags from up to 100 records at once. The tags stay in the project.update_tags
Arguments
Flags
Also takes the global flags.
Examples
Remove a tag from a task:
records and createdTags, as in oqoqo tags add: each record’s id, kind, and tags after the change.
Notes
You can run the command again safely. To remove a tag from every record and from the project, use oqoqo tags delete.
oqoqo tags rename
Rename a tag everywhere. Itstag_ ID stays, so every record keeps it.
rename_tag
Arguments
Flags
Also takes the global flags.
Examples
Rename a tag:
tag, with its id, name, usage, createdAt, and updatedAt.
Notes
A name that another tag already has, in any case, fails with tag_name_taken. A tag that changed since you read it fails with tag_changed, so run the command again.
oqoqo tags delete
Delete a tag from the project and every record. The records stay.delete_tag
Arguments
Flags
Also takes the global flags.
Examples
Delete a tag in a script:
Notes
A tag the project doesn’t have fails with
tag_not_found. When you delete a tagged task, tool, treatment, or experiment, its tags stay in the project.
Filter lists by tag
oqoqo catalog list and oqoqo experiments list take two tag filters.
A tag the project doesn’t have fails with
tag_not_found, not an empty list, and details.tags names it. Each returned record lists its tags.
Names and limits
Related
Tags
Add and filter tags in the dashboard.
oqoqo catalog, resources, and uploads
Find tagged tasks, tools, and treatments.
oqoqo experiments
Find tagged experiments.
IDs and limits
Every ID prefix and product limit.

