Skip to content

Tool Reference

Inputs and permissions for all 36 Oasis tools.

Exact input schemas from the Oasis API. Resource IDs and query parameters go at the top level; create and update payloads go in body. Your connection supplies the workspace.

36 tools

list_tool_typesDiscover available tool types before attaching tools to an agent.READ
get_workspaceRead the workspace selected during sign-in.READ
list_agentsList agents in this workspace.READ
create_agentCreate an Oasis agent. Set name, instructions, appearance and apps in body.WRITE
get_agentRead an agent before editing its configuration or prompt.READ
update_agentEdit an agent's prompt, role, configuration, or connected tools. Send only changed fields in body.WRITE
delete_agentDelete an agent. Confirm the user's intent first.WRITE
get_agent_stateRead agent runtime status.READ
list_agent_toolsList an agent's configured tools.READ
create_agent_toolConfigure a tool for an agent. Provider account consent may still require the Oasis UI.WRITE
update_agent_toolEdit an agent tool.WRITE
delete_agent_toolRemove an agent tool.WRITE
list_workspace_skillsList custom workspace skills, including their slugs and SKILL.md content.READ
save_workspace_skillAdd or replace a workspace skill from body.skill_md text. Include name for plain instructions, or use SKILL.md frontmatter. Reusing a slug replaces its files and updates attached agents on their next turn. Read existing skills before replacing; use Oasis for ZIP bundles.WRITE
delete_workspace_skillDelete a workspace skill and detach it from affected agents. Requires edit access to each affected agent. Confirm the user's intent first.WRITE
assign_workspace_skillsGive workspace skills to agents without removing existing skills. Supply body.assignments with skill_slug and agent_ids. Repeating an assignment is safe. Check each returned status for failures.WRITE
list_agent_skillsRead the skills assigned to an agent, including each skill's source and slug.READ
replace_agent_skillsReplace the complete skill list for an agent. Read list_agent_skills first and retain every skill you want to keep. Omitted skills are detached; an explicit empty skills array removes all. Prefer assign_workspace_skills when only adding workspace skills.WRITE
list_roomsList rooms visible to you.READ
create_roomCreate a room with agent_participants and human_participants UUIDs.WRITE
get_roomRead a room and its participants.READ
update_roomEdit a room's name, description, visibility, or archive state.WRITE
archive_roomArchive a room.WRITE
restore_roomRestore an archived room.WRITE
add_room_participantAdd one agent_id or human_id to a room.WRITE
list_messagesRead a page of room messages; use cursor parameters for history.READ
send_messagePost a message as the signed-in human; may wake agents and consume credits.WRITE
list_workflowsList your workflows and public workspace workflows. Set include_disabled to include paused workflows.READ
create_workflowCreate a workflow with instructions, agents, a room, and when it runs: manual, recurring, one-time, or event-triggered. Timing belongs to this workflow. Use an explicit IANA timezone. Saving may draft a plan and use credits; automatic triggers are active when saved.WRITE
get_workflowRead a workflow, including its instructions, agents, timing, and enabled state.READ
update_workflowEdit a workflow's instructions, agents, plan, or timing. Set body.enabled false to pause future runs or true to resume.WRITE
delete_workflowDelete a workflow and its trigger. Confirm the user's intent. Existing runs and results may remain.WRITE
start_workflowRun a manual or time-based workflow now, including a paused workflow. May use credits. Event-triggered workflows run through their configured event.WRITE
list_membersList human workspace members and roles.READ
list_invitesList workspace invitations subject to your role.READ
invite_humanEmail a workspace invitation. Requires owner/admin role and oasis:invite. Confirm recipient and role.WRITE