agentProfileClearBrowserCache
Clear the persisted browser cache (cookies, storage) for an agent profile, resetting its browser state.
agentList
List all agents for an organization. Pass the `organizationId` from `getContext` (use `getContext` first if you only know the org name).
agentCreate
Create a NEW agent (not a new version of an existing one). Requires `organizationId` (from `getContext`), a human-friendly `name`, and an initial `workflow` graph — the backend always seeds an agent with a first workflow. For a blank-but-runnable agent, pass a minimal starter: one start `iris` node plus `success` and `failure` `output` nodes, with `settings.new_agent_loop: true`. For a pre-built agent, pass a fuller graph (same JSON shape as `workflowCreate`). Use `listAvailableTools` to pick node tools and `schemaValidate` for any output schemas. The created agent's first workflow is unpublished; publish it with `workflowPublish` before `agentExecutePost`.
agentExecutePost
Start an execution for the given agent
agentDelete
Permanently delete an agent and all of its workflows by `agentId`. This is irreversible. Only allowed when all of the agent's executions are in a terminal status (completed, cancelled, or failed); otherwise the request is rejected. Use `agentList` to find the `agentId` first.
executionsList
List executions with filtering and pagination
executionGet
Get a single execution by ID with all details
executionActivitiesGet
Get activities for an execution
executionAgentFilesGet
Get all files for an execution, grouped by directory (uploads, downloads, workspace, shared, debug). Files are tracked by the file syncer daemon during execution. Debug files are only visible to admins.
executionContextFilesGet
Get all context files attached to an execution
executionStatusUpdate
Update the status of an execution (pause, resume, or cancel)
executionUserMessagesAdd
Add a user message to an execution
listAvailableTools
List all available tools/capabilities that can be assigned to AI Task nodes in workflows
workflowsList
List all versions of an agent (lightweight refs with IDs, parents, and version numbers).
workflowCreate
Create a new agent version with a full graph (nodes, transitions), rules, and settings. This is how you update an agent's behavior. Set `parentId` to the current version's ID to maintain lineage. The new version is unpublished until you call `workflowPublish`.
workflowGet
Get a full agent version by ID, including the complete node graph, rules, and settings.
workflowPublish
Publish an agent version, assigning it a permanent version number and making it the default for `agentExecutePost`.
workflowExecute
Execute a specific agent version (published or unpublished) directly, useful for testing before publishing.
workflowSyncExecution
Sync a running execution to use a specific agent version.
schemaValidate
Validate a JSON schema against OpenAI structured output requirements
agentSharedFilesGet
List all persistent shared files for an agent. These files persist across executions and are automatically restored when a new execution starts.
agentSharedFilesDelete
Delete a file from the agent's persistent shared storage.
agentSharedFilesDeleteAll
Delete all shared files for an agent.
agentSharedFilesFreeze
Set the frozen status of a shared file. Frozen files are preserved across executions and cannot be overwritten by the agent.
searchDocs
Search Asteroid documentation for guides on building agents, node types, and best practices