Tool reference

Use your client's tools/list discovery for the current input schemas, required fields, filters, and pagination. Both local stdio and remote OAuth expose the shared v1 tools below. The hosted server also has ten compatibility tools for common task and session operations.

Remote convenience tools

Tool	Purpose
`uno_get_workspace`	Read the selected workspace and repository IDs.
`uno_list_tasks`	List tasks with bounded pagination.
`uno_get_task`	Read a task by `taskId`.
`uno_create_task`	Create a task using `input` and a stable `requestId`; does not start execution.
`uno_update_task`	Change task properties using `taskId` and `input`.
`uno_list_sessions`	List workspace sessions.
`uno_get_session`	Read a session and its conversations.
`uno_get_messages`	Read persisted messages by `conversationId`.
`uno_create_session`	Submit `objective` to selected `repositoryIds` with a stable `requestId`.
`uno_send_message`	Send an idle follow-up using `conversationId`, `text`, and stable `requestId`.

Follow the session workflow before starting or steering work. objective alone on the advanced post_workspaces_sessions tool creates an idle session; include body.initialConversation.message to execute.

Shared v1 catalog

The following catalog is synchronized from Uno's explicit capability allowlist. Availability does not mean every feature is enabled for your workspace; existing role, billing, and product checks still apply. Repository wiki functionality is currently paused.

Tool	Purpose
`delete_api_v1_workspaces_environment_manifests`	Delete a workspace environment manifest.
`delete_api_v1_workspaces_environment_manifests_files`	Remove a file from a workspace environment manifest.
`delete_api_v1_workspaces_repositories_manifests`	Delete a repository environment manifest.
`delete_api_v1_workspaces_repositories_manifests_files`	Remove a file from a repository environment manifest.
`delete_workspaces_agents_routines`	Delete an agent routine and stop future scheduled runs.
`delete_workspaces_repositories_rules`	Delete a repository rule, checking its expected revision.
`delete_workspaces_session_image_assets`	Remove an image attachment from a session draft.
`delete_workspaces_skills`	Remove a skill from a workspace.
`delete_workspaces_tasks`	Delete a workspace task.
`delete_workspaces_tasks_parent`	Remove a task's parent relationship.
`delete_workspaces_tasks_sessions`	Remove the link between a task and a session.
`delete_workspaces_wiki_sources`	Remove a source from a repository wiki.
`get_api_v1_workspaces_environment_manifests`	List environment manifests scoped to a workspace.
`get_api_v1_workspaces_environment_manifests_by_id`	Read an environment manifest's YAML and activation state.
`get_api_v1_workspaces_environment_manifests_files`	List uploaded files required by an environment manifest.
`get_api_v1_workspaces_environment_manifests_revisions`	List the saved revisions of an environment manifest.
`get_api_v1_workspaces_repositories_manifests`	List environment manifests scoped to a repository.
`get_api_v1_workspaces_repositories_manifests_by_id`	Read an environment manifest's YAML and activation state.
`get_api_v1_workspaces_repositories_manifests_files`	List uploaded files required by an environment manifest.
`get_api_v1_workspaces_repositories_manifests_revisions`	List the saved revisions of an environment manifest.
`get_conversations_activity`	Read an agent conversation's latest tool and turn activity after checking get_conversations_status. Use the conversation ID returned by session creation; this is a read and does not start execution.
`get_conversations_activity_history`	Read completed turn and tool activity history for a conversation.
`get_conversations_by_id`	Read an agent conversation and its current state.
`get_conversations_events`	Read conversation events after a sequence number to monitor ongoing work.
`get_conversations_messages`	Read persisted messages in an agent conversation.
`get_conversations_status`	Verify execution after session creation using the returned primary_conversation_id (or next_action.arguments.conversationId). Inspect latest_turn_status: queued means accepted, running means executing, completed/failed/cancelled are terminal; null means no turn is recorded yet. Check activity_status for pending input before recovery. Session ready is only environment readiness. Do not resend an accepted objective. Use get_conversations_activity for progress and get_conversations_messages for persisted messages.
`get_conversations_steering`	Check whether session steering is supported and verify delivery. Returns data.supported, data.requests and data.messages. Match the accepted data.steering.id to requests[].id; pending/delivering are not delivery. delivered confirms runtime acknowledgment unless continuation_turn_id is set, meaning saved guidance became a queued follow-up; inspect get_conversations_status. failed/cancelled require inspection. Omit query.turnId to track requests across continuation retargeting. Unsupported runtimes need an upgrade; never automatically stop or resend accepted guidance.
`get_conversations_timeline`	Read a paginated conversation timeline or locate a particular input message.
`get_conversations_turns_activity`	Read incremental activity for a conversation turn after a sequence number.
`get_delegations_by_id`	Read a delegation's objective, target agent, progress, and handoff.
`get_knowledge_documents_versions`	List recorded versions of a knowledge document.
`get_knowledge_refreshes_by_id`	Read a legacy knowledge refresh and its published documents.
`get_knowledge_search`	Search accessible workspace knowledge, optionally within one workspace.
`get_loops_by_id`	Read a work loop, its repository selections, runs, and review rounds.
`get_outputs_assets`	List files attached to an output artifact.
`get_outputs_assets_download_url`	Get a signed download URL for a file attached to an output artifact.
`get_outputs_by_id`	Read an output artifact, its content, and related file assets.
`get_outputs_media`	Read computer-use screenshots or recordings attached to an output.
`get_repositories_head_events`	List recorded branch head updates for a repository.
`get_repositories_knowledge_refreshes`	List legacy knowledge refresh history for a repository.
`get_repositories_review_campaigns`	List review campaigns for a repository.
`get_review_campaigns_by_id`	Read a review campaign and its findings and decision state.
`get_review_campaigns_findings`	List findings from a repository review campaign.
`get_session_specs_by_id`	Read a session specification, proposal, design, and checklist.
`get_sessions_by_id`	Read a session, its repositories, conversations, and sandbox details.
`get_sessions_changes`	Inspect repository changes produced by a session.
`get_sessions_changes_file`	Read the patch for a changed repository file in a session.
`get_sessions_conversations`	List the agent conversations within a session.
`get_sessions_files`	Read a repository file from a session sandbox.
`get_sessions_outputs`	List output artifacts from a session, optionally including child sessions.
`get_sessions_previews`	List application previews available for a session.
`get_sessions_sandbox`	Read sandbox details for a session.
`get_sessions_sandbox_status`	Read the current availability and lifecycle status of a session sandbox.
`get_sessions_specs`	List specifications produced in a session.
`get_sessions_tree`	Read a session's conversations, child sessions, delegations, and output relationships.
`get_sessions_view`	Read a session conversation view with optional message history.
`get_sessions_workspace_requests`	List pending environment and secret requests that require user input.
`get_workspaces`	List the workspaces you belong to and your membership roles.
`get_workspaces_agents`	List the agents available in a workspace.
`get_workspaces_agents_routines`	List scheduled routines using an agent UUID or a built-in agent key such as chief, engineering, oncall, security, code_intelligence, or product.
`get_workspaces_agents_routines_by_id`	Read an agent routine's prompt, schedule, repository selections, and revision.
`get_workspaces_agents_routines_runs`	Read execution history for a scheduled agent routine.
`get_workspaces_briefs`	List workspace brief documents.
`get_workspaces_briefs_by_id`	Read a workspace brief and its planning context.
`get_workspaces_by_id`	Read workspace details and your membership role.
`get_workspaces_loops`	List autonomous work loops and recent execution summaries.
`get_workspaces_members`	List workspace members, profile details, and roles.
`get_workspaces_model_configuration_options`	List available model, reasoning effort, and speed options for a workspace.
`get_workspaces_outputs`	List output artifacts produced across a workspace.
`get_workspaces_prompts`	List reusable workspace prompt templates and macros.
`get_workspaces_readiness_capacity`	Read workspace capacity readiness.
`get_workspaces_readiness_github`	Read workspace github readiness.
`get_workspaces_readiness_seed`	Read workspace seed readiness.
`get_workspaces_reports_code_intelligence`	List workspace code intelligence reports.
`get_workspaces_reports_code_intelligence_by_id`	Read a workspace code intelligence report and its structured results.
`get_workspaces_reports_oncall`	List workspace oncall reports.
`get_workspaces_reports_oncall_by_id`	Read a workspace oncall report and its structured results.
`get_workspaces_reports_qa`	List workspace quality assurance reports.
`get_workspaces_reports_qa_by_id`	Read a workspace quality assurance report and its structured results.
`get_workspaces_reports_release`	List workspace release reports.
`get_workspaces_reports_release_by_id`	Read a workspace release report and its structured results.
`get_workspaces_reports_security`	List workspace security reports.
`get_workspaces_reports_security_by_id`	Read a workspace security report and its structured results.
`get_workspaces_repositories`	List repositories attached to a workspace.
`get_workspaces_repositories_rules`	List instruction rules for a workspace repository.
`get_workspaces_repositories_rules_by_id`	Read a repository instruction rule and its revision.
`get_workspaces_rules`	List repository instruction rules across a workspace.
`get_workspaces_sandbox_inventory`	Inspect workspace sandboxes grouped by readiness and current work.
`get_workspaces_sandbox_preheat`	Read the current workspace sandbox preheat status.
`get_workspaces_seed_snapshot_status`	Read active seed readiness and pending or failed build information.
`get_workspaces_seed_snapshots`	List workspace seed snapshots and their build status.
`get_workspaces_seed_snapshots_detail`	Read a seed snapshot.
`get_workspaces_session_configuration`	Read repositories, prompts, model choices, and defaults before using post_workspaces_sessions with explicit settings. Include initialConversation.message to start execution.
`get_workspaces_session_preparations_by_id`	Check repository and sandbox preparation progress for a session draft.
`get_workspaces_session_repository_options`	List repositories available when composing a new session.
`get_workspaces_session_startups_by_id`	Check startup progress for a session creation request.
`get_workspaces_sessions`	List workspace sessions, optionally filtered by creator, agent, or planning context.
`get_workspaces_sessions_startup`	Inspect sandbox and agent startup steps for an existing session. Verify that an agent turn was accepted with get_conversations_status; a ready sandbox alone does not mean execution started.
`get_workspaces_sessions_tasks`	List workspace tasks linked to a session.
`get_workspaces_skills`	List the Markdown skills available to workspace agents.
`get_workspaces_skills_catalog`	Search the skill catalog.
`get_workspaces_skills_catalog_preview`	Preview a catalog skill.
`get_workspaces_skills_organization`	List organization skills.
`get_workspaces_skills_organization_detail`	Read organization skill details.
`get_workspaces_specs`	List workspace specification documents.
`get_workspaces_specs_by_id`	Read a workspace specification and its planning context.
`get_workspaces_tasks`	List tasks filtered by status, assignment, or parent relationship.
`get_workspaces_tasks_board`	Read a task board column with search, priority, label, source, and assignment filters.
`get_workspaces_tasks_by_id`	Read a workspace task and its planning and assignment details.
`get_workspaces_tasks_sessions`	List sessions linked to a workspace task.
`get_workspaces_warm_pool`	Read warm sandbox pool capacity, readiness, and seed information.
`get_workspaces_wiki`	List repository wikis and their readiness within a workspace.
`get_workspaces_wiki_by_id`	Read repository wiki metadata, versions, sources, and generation status.
`get_workspaces_wiki_code`	Search code symbols documented by a repository wiki.
`get_workspaces_wiki_code_by_id`	Read a documented code symbol and its source references.
`get_workspaces_wiki_diagrams`	List diagrams from a repository wiki version.
`get_workspaces_wiki_export`	Get a signed URL for downloading a generated repository wiki archive.
`get_workspaces_wiki_generations`	List documentation generation history for a repository wiki.
`get_workspaces_wiki_generations_by_id`	Read pages and status from a repository wiki generation.
`get_workspaces_wiki_graph`	Read the repository wiki concept and relationship graph.
`get_workspaces_wiki_llms_txt`	Read the repository wiki overview and page index as llms.txt text.
`get_workspaces_wiki_operations`	List public operations discovered in repository wiki sources.
`get_workspaces_wiki_pages`	Read a repository wiki page by its document path and optional version.
`get_workspaces_wiki_pages_markdown`	Download a repository wiki page as Markdown text.
`get_workspaces_wiki_revisions`	List published revisions of a repository wiki.
`get_workspaces_wiki_structure`	Read a repository wiki's page hierarchy and selected version.
`link_workspace_document_session`	Link a session to an existing workspace brief or specification.
`patch_loops`	Update a work loop's objective, repositories, models, or review policy.
`patch_prompts`	Update a reusable prompt template's name, Markdown content, or macro.
`patch_workspaces_agents_routines`	Enable or disable an agent routine, checking its current revision.
`patch_workspaces_repositories_rules`	Update a repository rule, checking its expected revision.
`patch_workspaces_settings`	Update sandbox capacity, loop limits, and default agent models.
`patch_workspaces_tasks`	Update task details, assignment, priority, labels, or repository context.
`patch_workspaces_wiki_settings`	Update repository wiki language, instructions, and generation settings.
`post_api_v1_workspaces_environment_manifests`	Create a workspace environment manifest with a name and YAML configuration.
`post_api_v1_workspaces_environment_manifests_activate`	Activate a workspace environment manifest for future sessions.
`post_api_v1_workspaces_environment_manifests_files`	Register an uploaded file and its destination in a workspace environment manifest.
`post_api_v1_workspaces_environment_manifests_files_upload_url`	Request a signed upload URL for a file required by a workspace environment manifest.
`post_api_v1_workspaces_repositories_manifests`	Create a repository environment manifest with a name and YAML configuration.
`post_api_v1_workspaces_repositories_manifests_activate`	Activate a repository environment manifest for future sessions.
`post_api_v1_workspaces_repositories_manifests_files`	Register an uploaded file and its destination in a repository environment manifest.
`post_api_v1_workspaces_repositories_manifests_files_upload_url`	Request a signed upload URL for a file required by a repository environment manifest.
`post_conversations_delegations`	Delegate conversation work to another agent with a goal and context.
`post_conversations_messages`	Send a first message or idle follow-up and start a turn. For guidance to a queued or running turn, use post_conversations_steer after reading get_conversations_status and get_conversations_steering. Reuse an explicit idempotencyKey on retries; do not resend an accepted initial objective.
`post_conversations_outputs`	Publish an output artifact produced by an agent conversation.
`post_conversations_steer`	Steer a session's queued or running agent without stopping it. Use the session's conversationId; read get_conversations_status data.turns for the active turn ID and get_conversations_steering data.supported first. Supply body.targetTurnId, body.text and a stable idempotencyKey; reuse identical arguments on retries. HTTP 202 confirms acceptance only. Save data.steering.id and verify its status via get_conversations_steering. On a stale-target conflict refresh status before deciding where new guidance belongs; do not blindly resend with a new key. Use post_conversations_messages for idle follow-ups.
`post_delegations_handoff`	Submit a delegation handoff with results for the receiving agent.
`post_knowledge_refreshes_publish`	Publish a completed legacy knowledge refresh.
`post_loop_review_rounds_decision`	Approve or reject the work produced in a loop review round.
`post_loop_review_rounds_pause`	Pause the decision countdown for a loop review round.
`post_loop_review_rounds_resume`	Resume the decision countdown for a loop review round.
`post_loop_runs_terminate`	Terminate a running loop iteration.
`post_loops_disable`	Disable automatic execution of a work loop.
`post_loops_enable`	Enable an autonomous work loop.
`post_loops_run`	Request a new iteration of a work loop.
`post_outputs_assets_complete`	Verify an uploaded output asset's checksum and mark it ready.
`post_outputs_assets_upload_url`	Request a signed upload URL for a file attached to an output artifact.
`post_outputs_relations`	Relate one output to another as a derivation, review, replacement, aggregation, or blocker.
`post_repositories_head_events`	Record a repository branch head update and optionally refresh knowledge or seed resources.
`post_repositories_review_campaigns`	Start a review campaign for a repository commit range using a selected prompt.
`post_review_campaigns_decision`	Record a campaign review decision with an optional note.
`post_review_findings_decision`	Accept, reject, defer, mark fixed, or mark a review finding as a duplicate.
`post_sessions_archive`	Archive a session and make it read-only.
`post_sessions_cancel`	Cancel a session and its ongoing work with an optional reason.
`post_sessions_complete`	Mark a session complete with an optional summary.
`post_sessions_conversations`	Create an agent conversation within a session.
`post_sessions_desktop`	Start or access the remote desktop for a session sandbox.
`post_sessions_previews_access`	Get an authorized access URL for a session's application preview.
`post_sessions_sandbox_assignment_retry`	Retry a failed session sandbox assignment.
`post_sessions_sandbox_ensure`	Ensure a session has an available sandbox.
`post_sessions_sandbox_wake`	Wake a paused session sandbox.
`post_turns_cancel`	Cancel an active agent turn.
`post_turns_recover`	Recover an interrupted or failed agent turn.
`post_turns_retry`	Retry an agent turn and return the accepted execution.
`post_workspace_requests_clarification`	Answer a workspace request clarification.
`post_workspace_requests_manifest_resolution`	Approve or reject an agent's environment manifest request.
`post_workspace_requests_repository_rule_resolution`	Approve or reject an agent's proposed repository rule change with an optional note.
`post_workspaces_agents`	Create a workspace agent with its role, description, and delegation permissions.
`post_workspaces_agents_routines`	Create a scheduled agent routine with its prompt and repository selections.
`post_workspaces_agents_routines_preview`	Calculate the next occurrence of a proposed agent routine schedule.
`post_workspaces_briefs_sessions`	Link a planning session to an existing workspace brief.
`post_workspaces_loops`	Create an autonomous work loop with repositories, a root prompt, and review settings.
`post_workspaces_prompts`	Create a reusable workspace prompt template and macro.
`post_workspaces_reports_oncall_approve`	Approve a oncall report so its proposed work can proceed.
`post_workspaces_reports_oncall_request_changes`	Request changes to a oncall report and provide the agent with revision guidance.
`post_workspaces_repositories_rules`	Add a Markdown instruction rule for a workspace repository.
`post_workspaces_sandbox_preheat`	Request early sandbox preparation before starting workspace work.
`post_workspaces_seed_snapshot_builds_retry`	Retry a failed workspace seed snapshot build.
`post_workspaces_seed_snapshots_build`	Request a fresh workspace seed snapshot for faster session startup.
`post_workspaces_session_image_assets_complete`	Verify an uploaded session image attachment and make it available to a draft.
`post_workspaces_session_image_assets_upload_url`	Request a signed upload URL for an image attachment in a session draft.
`post_workspaces_session_preparations`	Prepare repositories and sandbox resources for a session draft.
`post_workspaces_sessions`	Create a session with explicit repositories and optional agent/model settings. To START execution, supply body.initialConversation.message as {"text":"the complete instructions"}; body.objective alone creates an idle session. Use a stable explicit idempotencyKey on retries. The response envelope contains data.id and data.primary_conversation_id; verify execution with get_conversations_status using that conversation ID. A creating/ready session or HTTP 202 does not prove an agent is running. Remote clients can use uno_create_session for automatic objective submission with workspace defaults.
`post_workspaces_skills`	Add a named Markdown skill for agents in a workspace.
`post_workspaces_skills_install`	Install an organization skill.
`post_workspaces_skills_retry`	Retry a failed skill installation.
`post_workspaces_skills_update`	Update an installed skill.
`post_workspaces_specs_approve`	Approve a specification so its proposed work can proceed.
`post_workspaces_specs_request_changes`	Request changes to a specification and provide the agent with revision guidance.
`post_workspaces_specs_sessions`	Link a planning session to an existing workspace specification.
`post_workspaces_tasks`	Create a workspace task with its title, details, assignment, and optional parent.
`post_workspaces_tasks_reopen`	Reopen a completed task for further work.
`post_workspaces_tasks_start`	Start work on a workspace task and create its execution session.
`post_workspaces_tasks_transition`	Change a task's workflow status and optional board position.
`post_workspaces_warm_pool_reconcile`	Reconcile the workspace warm sandbox pool with its configured capacity.
`post_workspaces_wiki_ask`	Ask a repository wiki a question or request deep research and return its streamed answer.
`post_workspaces_wiki_ask_cancel`	Cancel a running repository wiki question or deep research request.
`post_workspaces_wiki_drafts`	Save an editable wiki page draft with Markdown content and frontmatter.
`post_workspaces_wiki_drafts_publish`	Publish an edited wiki page draft.
`post_workspaces_wiki_feedback`	Rate a wiki answer and optionally provide written feedback.
`post_workspaces_wiki_generations_cancel`	Cancel a running repository wiki generation.
`post_workspaces_wiki_generations_retry`	Retry a failed repository wiki generation.
`post_workspaces_wiki_previews`	Create a documentation preview for a branch, tag, or pull request.
`post_workspaces_wiki_refresh`	Regenerate repository documentation from current source information.
`post_workspaces_wiki_revisions_rollback`	Restore a repository wiki to a previous revision.
`post_workspaces_wiki_search`	Search repository wiki pages for a question or phrase.
`post_workspaces_wiki_sources`	Add a repository, API, or runtime source to a repository wiki.
`post_workspaces_wiki_sources_openapi`	Import an OpenAPI source into a repository wiki.
`post_workspaces_wiki_sources_runtime`	Import runtime tracing spans into a repository wiki source.
`put_api_v1_workspaces_environment_manifests`	Update a workspace environment manifest and record a change summary.
`put_api_v1_workspaces_repositories_manifests`	Update a repository environment manifest and record a change summary.
`put_workspaces_agents_routines`	Update an agent routine, checking its current revision.
`put_workspaces_reports_oncall_acceptance`	Record a pending, pass, fail, or blocked result and evidence for a oncall report acceptance criterion.
`put_workspaces_specs_acceptance`	Record a pending, pass, fail, or blocked result and evidence for a specification acceptance criterion.
`put_workspaces_tasks_parent`	Set the parent task for a workspace task.
`put_workspaces_tasks_sessions`	Link a session to a workspace task.
`rename_session`	Rename a session to make its work easier to identify.
`save_workspace_brief`	Create or update a workspace brief with its proposed work and planning context.
`save_workspace_spec`	Create or update a workspace specification with its proposal and acceptance criteria.

Remote convenience toolsCopy Anchor Link

Shared v1 catalogCopy Anchor Link

On this page

Remote convenience tools

Shared v1 catalog