Skip to main content
Read your signed-in identity and organization, switch project scope, and create, rename, or delete projects. See Projects for how projects organize resources.
  • 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

get_identity

Get the signed-in user and organization. Returns your Oqoqo user and signed-in organization. Send organization.id as expected_organization_id on every write. Read-only · CLI: oqoqo whoami This tool takes no parameters.

get_project_context

Get the organization and its projects. Returns the organization and its projects, with the values manage_project needs to rename one. Read-only · CLI: oqoqo projects list, oqoqo projects current, oqoqo projects use, oqoqo projects inspect When the installed Oqoqo Plugin needs an update, the result also has pluginUpdate: the level (recommended or required), installedVersion, latestVersion, a message for the person, and steps with the update commands for each host. Tell the person, then continue their request.

manage_project

Create or rename a project. It follows the same rules as the dashboard (Projects). Changes data · CLI: oqoqo projects create, oqoqo projects update

preview_delete_project

Preview project deletion. Counts what deleting a project removes by kind, the running experiments it stops, and the blockers. Show the result to the person before delete_project. Read-only · CLI: oqoqo projects delete --dry-run

delete_project

Permanently delete a project. Deletes a project and everything in it, from tasks, tools, and treatments to experiments, schedules, runs, Evals, and Insights. Running experiments stop first; the result says how many. Destructive · Irreversible · CLI: oqoqo projects delete With blockers, it returns project_deletion_blocked and deletes nothing. An already deleted project returns project_not_found.

Catalog, resources, and uploads tools

Create and manage tasks, files, machines, tools, and treatments.

oqoqo projects

The matching CLI commands and flags.