# Asteroid Agents

## Docs

- [Add Profiles to Pool](https://docs.asteroid.ai/api-reference/agent-profile-pools/add-profiles-to-pool.md): Add profiles to a pool
- [Create Agent Profile Pool](https://docs.asteroid.ai/api-reference/agent-profile-pools/create-agent-profile-pool.md): Create a new agent profile pool
- [Delete Agent Profile Pool](https://docs.asteroid.ai/api-reference/agent-profile-pools/delete-agent-profile-pool.md): Delete an agent profile pool
- [Get Agent Profile Pool](https://docs.asteroid.ai/api-reference/agent-profile-pools/get-agent-profile-pool.md): Get an agent profile pool by ID
- [List Agent Profile Pools](https://docs.asteroid.ai/api-reference/agent-profile-pools/list-agent-profile-pools.md): List all agent profile pools for an organization
- [List Pool Members](https://docs.asteroid.ai/api-reference/agent-profile-pools/list-pool-members.md): List all profiles in a pool
- [Remove Profiles from Pool](https://docs.asteroid.ai/api-reference/agent-profile-pools/remove-profiles-from-pool.md): Remove profiles from a pool
- [Update Agent Profile Pool](https://docs.asteroid.ai/api-reference/agent-profile-pools/update-agent-profile-pool.md): Update an existing agent profile pool
- [Clear Browser Cache](https://docs.asteroid.ai/api-reference/agent-profiles/clear-browser-cache.md): Clears the browser profile/cache for the specified agent profile by deleting its browser profile
- [Create Agent Profile](https://docs.asteroid.ai/api-reference/agent-profiles/create-agent-profile.md): Create a new agent profile
- [Delete Agent Profile](https://docs.asteroid.ai/api-reference/agent-profiles/delete-agent-profile.md): Delete an agent profile
- [Duplicate Agent Profile](https://docs.asteroid.ai/api-reference/agent-profiles/duplicate-agent-profile.md): Duplicate an agent profile with all settings, credentials, and cookies
- [Get Agent Profile](https://docs.asteroid.ai/api-reference/agent-profiles/get-agent-profile.md): Get an agent profile by ID
- [Get Agent Profile Inbox Email](https://docs.asteroid.ai/api-reference/agent-profiles/get-agent-profile-inbox-email.md): Get a single email from the agent profile's inbox by ID
- [Get Agent Profile Inbox Emails](https://docs.asteroid.ai/api-reference/agent-profiles/get-agent-profile-inbox-emails.md): List emails in the agent profile's inbox
- [List Agent Profiles](https://docs.asteroid.ai/api-reference/agent-profiles/list-agent-profiles.md): List all agent profiles for an organization
- [Update Agent Profile](https://docs.asteroid.ai/api-reference/agent-profiles/update-agent-profile.md): Update an existing agent profile
- [Execute an agent](https://docs.asteroid.ai/api-reference/agents/execute-an-agent.md): Start an execution for the given agent.
- [List Agents](https://docs.asteroid.ai/api-reference/agents/list-agents.md): List all agents for an organization
- [List Available Tools](https://docs.asteroid.ai/api-reference/agents/list-available-tools.md): List all available tools/capabilities for AI Task nodes in workflows
- [Get Context](https://docs.asteroid.ai/api-reference/context/get-context.md): Get the current user's context including organization memberships
- [Get execution](https://docs.asteroid.ai/api-reference/execution/get-execution.md): Get a single execution by ID with all details
- [Get recording redirect](https://docs.asteroid.ai/api-reference/execution/get-recording-redirect.md): Redirect to the recording playback URL. Returns a 307 with a short-lived signed URL. Embed this endpoint in <video> tags — the player will follow the redirect and re-fetch on expiry.
- [List executions](https://docs.asteroid.ai/api-reference/execution/list-executions.md): List executions with filtering and pagination
- [Retrieve execution activities](https://docs.asteroid.ai/api-reference/execution/retrieve-execution-activities.md): Get activities for an execution
- [Send user message to execution](https://docs.asteroid.ai/api-reference/execution/send-user-message-to-execution.md): Add a user message to an execution
- [Update execution status](https://docs.asteroid.ai/api-reference/execution/update-execution-status.md): Update the status of an execution. Use this to pause, resume, or cancel an execution.
- [Delete Agent Shared File](https://docs.asteroid.ai/api-reference/files/delete-agent-shared-file.md): Delete a file from the agent's persistent shared storage.
- [Delete All Agent Shared Files](https://docs.asteroid.ai/api-reference/files/delete-all-agent-shared-files.md): Delete all shared files for an agent.
- [Download agent file](https://docs.asteroid.ai/api-reference/files/download-agent-file.md): Redirects to a short-lived signed URL for downloading the file.
- [Download context file](https://docs.asteroid.ai/api-reference/files/download-context-file.md): Redirects to a short-lived signed URL for downloading the file.
- [Download debug file](https://docs.asteroid.ai/api-reference/files/download-debug-file.md): Redirects to a short-lived signed URL for downloading the file.
- [Download shared file](https://docs.asteroid.ai/api-reference/files/download-shared-file.md): Redirects to a short-lived signed URL for downloading the file.
- [Get Agent Files](https://docs.asteroid.ai/api-reference/files/get-agent-files.md): Get all agent files for an execution, grouped by directory. Files are tracked by the file syncer daemon during execution.
- [Get Agent Shared Files](https://docs.asteroid.ai/api-reference/files/get-agent-shared-files.md): Get all persistent shared files for an agent. These files persist across executions and are automatically restored when a new execution starts.
- [Get Execution Context Files](https://docs.asteroid.ai/api-reference/files/get-execution-context-files.md): Get all context files attached to an execution
- [Set Freeze on Agent Shared File](https://docs.asteroid.ai/api-reference/files/set-freeze-on-agent-shared-file.md): Set the frozen status of a shared file. Frozen files are preserved across executions and cannot be overwritten by the agent.
- [Stage a file for an execution](https://docs.asteroid.ai/api-reference/files/stage-a-file-for-an-execution.md): Stage a file prior to starting an execution, so that it can be used when the execution is started. See the /agents/{agentId}/execute to understand how to pass the returned file information to the execution endpoint.
- [Update Agent Shared File](https://docs.asteroid.ai/api-reference/files/update-agent-shared-file.md): Replace the contents of a shared file. The request body must contain exactly one file.
- [Upload Agent Shared Files](https://docs.asteroid.ai/api-reference/files/upload-agent-shared-files.md): Upload one or more files to the agent's persistent shared storage. Files are available across all executions.
- [Upload Execution Context Files](https://docs.asteroid.ai/api-reference/files/upload-execution-context-files.md): Upload files to a running execution that is already in progress. If you want to attach files to an execution that is not yet running, see the /temp-files endpoint.
- [API Quickstart](https://docs.asteroid.ai/api-reference/quickstart.md): Get started with the Asteroid API and SDKs
- [Webhook Notification Payload](https://docs.asteroid.ai/api-reference/webhook-notification-payload.md): Example endpoint to expose the webhook notification schema. This operation is for documentation purposes only.
- [Best Practices](https://docs.asteroid.ai/astro/best-practices.md): Tips for getting the most out of Astro
- [Getting Started](https://docs.asteroid.ai/astro/getting-started.md): Learn how to access and start using Astro
- [How It Works](https://docs.asteroid.ai/astro/how-it-works.md): Learn more about how Astro works
- [Migrating to the New Agent Loop](https://docs.asteroid.ai/astro/migrate.md): Use Astro's /migrate command to upgrade your agent from the legacy loop to the new iris-based loop
- [AI Capabilities](https://docs.asteroid.ai/fundamentals/ai-capabilities.md): Available capabilities for your AI Task nodes
- [Batch Executions](https://docs.asteroid.ai/fundamentals/batch-executions.md): Run your agent across multiple inputs in bulk with controlled scheduling and concurrency
- [Environments](https://docs.asteroid.ai/fundamentals/environments.md): Browser, Linux, and Windows environments for agent execution
- [Execution Statuses](https://docs.asteroid.ai/fundamentals/execution-statuses.md): Understanding the lifecycle of agent executions
- [Agent Filesystem](https://docs.asteroid.ai/fundamentals/files.md): A full filesystem where agents create files, run scripts, and persist knowledge across executions
- [Graph Agents](https://docs.asteroid.ai/fundamentals/graph-agents.md): Graph workflows, nodes, transitions, and context patterns on Asteroid
- [Overview](https://docs.asteroid.ai/fundamentals/integrations/overview.md): Learn how to connect Asteroid Agents to external services
- [Slack](https://docs.asteroid.ai/fundamentals/integrations/slack.md): Send real-time notifications to your Slack channels
- [Webhooks](https://docs.asteroid.ai/fundamentals/integrations/webhooks.md): Set up webhooks for real-time execution notifications
- [AI Task Node](https://docs.asteroid.ai/fundamentals/nodes/ai-task.md): Instruct an LLM to interact with a webpage
- [Output Node](https://docs.asteroid.ai/fundamentals/nodes/output.md): Terminate the workflow and return results with a custom outcome label
- [Agent Profiles](https://docs.asteroid.ai/fundamentals/profiles.md): Manage browser automation profiles, authentication credentials, 2FA, and cookies persistence for consistent execution environments
- [Agent Settings](https://docs.asteroid.ai/fundamentals/settings.md): Configure your agent settings and preferences in the `Settings` panel
- [Transitions](https://docs.asteroid.ai/fundamentals/transitions.md): How workflows decide what happens next
- [Quickstart](https://docs.asteroid.ai/get-started/quickstart.md): Build your first agent in minutes
- [Welcome](https://docs.asteroid.ai/get-started/welcome.md): Learn how to automate complex browser workflows with Asteroid agents
- [MCP Server](https://docs.asteroid.ai/mcp/overview.md): Connect your AI coding assistant to Asteroid via the Model Context Protocol
- [Setup](https://docs.asteroid.ai/mcp/setup.md): Add the Asteroid MCP server to Claude Code or Cursor
- [Cookbook](https://docs.asteroid.ai/sdks/cookbook.md): Practical examples for the current Asteroid TypeScript and Python SDKs
- [Python SDK](https://docs.asteroid.ai/sdks/python.md): Use the Asteroid Python SDK to execute agents, monitor runs, and manage profiles
- [Setup](https://docs.asteroid.ai/sdks/setup.md): Hook your agent up to Asteroid in minutes
- [TypeScript SDK](https://docs.asteroid.ai/sdks/typescript.md): Use the Asteroid TypeScript SDK to execute agents, monitor runs, and manage profiles
- [Security & Compliance](https://docs.asteroid.ai/support-security/security.md): Security measures and compliance information
- [Support](https://docs.asteroid.ai/support-security/support.md): Get help with Asteroid
- [Changelog](https://docs.asteroid.ai/whats-new/changelog.md): Product updates and announcements

## OpenAPI Specs

- [openapi](https://odyssey.asteroid.ai/webhooks/openapi.json)