# Runloop AI Docs

## Docs

- [Create an Agent.](https://docs.runloop.ai/api-reference/agents/create-an-agent.md): Create a new Agent with a name and optional public visibility. The Agent will be assigned a unique ID.
- [Get an Agent.](https://docs.runloop.ai/api-reference/agents/get-an-agent.md): Retrieve a specific Agent by its unique identifier.
- [Get Devbox counts by Agent.](https://docs.runloop.ai/api-reference/agents/get-devbox-counts-by-agent.md): Returns devbox counts grouped by agent name. This endpoint efficiently aggregates devbox counts for all agents in a single request, avoiding N+1 query patterns.
- [List Agents.](https://docs.runloop.ai/api-reference/agents/list-agents.md): List all Agents for the authenticated account with pagination support.
- [List Public Agents.](https://docs.runloop.ai/api-reference/agents/list-public-agents.md): List all public Agents with pagination support.
- [[Beta] Create a BenchmarkJob.](https://docs.runloop.ai/api-reference/benchmark/[beta]-create-a-benchmarkjob.md): [Beta] Create a BenchmarkJob that runs a set of scenarios entirely on runloop.
- [[Beta] Get a previously created BenchmarkJob.](https://docs.runloop.ai/api-reference/benchmark/[beta]-get-a-previously-created-benchmarkjob.md): [Beta] Get a BenchmarkJob given ID.
- [[Beta] List BenchmarkJobs.](https://docs.runloop.ai/api-reference/benchmark/[beta]-list-benchmarkjobs.md): [Beta] List all BenchmarkJobs matching filter.
- [Cancel a Benchmark run. This will do the following: 1. Cancel all running scenarios and shutdown the underlying Devbox resources 2. Update the benchmark state to CANCELED 3. Calculate final score from completed scenarios](https://docs.runloop.ai/api-reference/benchmark/cancel-a-benchmark-run-this-will-do-the-following:-1-cancel-all-running-scenarios-and-shutdown-the-underlying-devbox-resources-2-update-the-benchmark-state-to-canceled-3-calculate-final-score-from-completed-scenarios.md): Cancel a currently running Benchmark run.
- [Cancel a Benchmark run. This will do the following: 1. Cancel all running scenarios and shutdown the underlying Devbox resources 2. Update the benchmark state to CANCELED 3. Calculate final score from completed scenarios](https://docs.runloop.ai/api-reference/benchmark/cancel-a-benchmark-run-this-will-do-the-following:-1-cancel-all-running-scenarios-and-shutdown-the-underlying-devbox-resources-2-update-the-benchmark-state-to-canceled-3-calculate-final-score-from-completed-scenarios-1.md): Cancel a currently running Benchmark run.
- [Complete a BenchmarkRun.](https://docs.runloop.ai/api-reference/benchmark/complete-a-benchmarkrun.md): Complete a currently running BenchmarkRun.
- [Complete a BenchmarkRun.](https://docs.runloop.ai/api-reference/benchmark/complete-a-benchmarkrun-1.md): Complete a currently running BenchmarkRun.
- [Create a Benchmark.](https://docs.runloop.ai/api-reference/benchmark/create-a-benchmark.md): Create a Benchmark with a set of Scenarios.
- [Download logs for a Benchmark run.](https://docs.runloop.ai/api-reference/benchmark/download-logs-for-a-benchmark-run.md): Download a zip file containing all logs for a Benchmark run.
- [Download logs for a Benchmark run.](https://docs.runloop.ai/api-reference/benchmark/download-logs-for-a-benchmark-run-1.md): Download a zip file containing all logs for a Benchmark run.
- [Get a Benchmark.](https://docs.runloop.ai/api-reference/benchmark/get-a-benchmark.md): Get a previously created Benchmark.
- [Get a previously created BenchmarkRun.](https://docs.runloop.ai/api-reference/benchmark/get-a-previously-created-benchmarkrun.md): Get a BenchmarkRun given ID.
- [Get a previously created BenchmarkRun.](https://docs.runloop.ai/api-reference/benchmark/get-a-previously-created-benchmarkrun-1.md): Get a BenchmarkRun given ID.
- [Get runs for a provided Benchmark.](https://docs.runloop.ai/api-reference/benchmark/get-runs-for-a-provided-benchmark.md): Get runs for a previously created Benchmark.
- [Get scenario definitions for a Benchmark.](https://docs.runloop.ai/api-reference/benchmark/get-scenario-definitions-for-a-benchmark.md): Get scenario definitions for a previously created Benchmark.
- [List available benchmark metadata keys.](https://docs.runloop.ai/api-reference/benchmark/list-available-benchmark-metadata-keys.md): Returns a list of all available metadata keys that can be used for filtering benchmarks.
- [List BenchmarkRuns.](https://docs.runloop.ai/api-reference/benchmark/list-benchmarkruns.md): List all BenchmarkRuns matching filter.
- [List BenchmarkRuns.](https://docs.runloop.ai/api-reference/benchmark/list-benchmarkruns-1.md): List all BenchmarkRuns matching filter.
- [List Benchmarks.](https://docs.runloop.ai/api-reference/benchmark/list-benchmarks.md): List all Benchmarks matching filter.
- [List Public Benchmarks.](https://docs.runloop.ai/api-reference/benchmark/list-public-benchmarks.md): List all public benchmarks matching filter.
- [List started scenario runs for a benchmark run.](https://docs.runloop.ai/api-reference/benchmark/list-started-scenario-runs-for-a-benchmark-run.md): List started scenario runs for a benchmark run.
- [List started scenario runs for a benchmark run.](https://docs.runloop.ai/api-reference/benchmark/list-started-scenario-runs-for-a-benchmark-run-1.md): List started scenario runs for a benchmark run.
- [List values for a specific benchmark metadata key.](https://docs.runloop.ai/api-reference/benchmark/list-values-for-a-specific-benchmark-metadata-key.md): Returns a list of all available metadata keys that can be used for filtering benchmarks.
- [Modify scenarios for a Benchmark.](https://docs.runloop.ai/api-reference/benchmark/modify-scenarios-for-a-benchmark.md): Add and/or remove Scenario IDs from an existing Benchmark.
- [Start a new BenchmarkRun.](https://docs.runloop.ai/api-reference/benchmark/start-a-new-benchmarkrun.md): Start a new BenchmarkRun based on the provided Benchmark.
- [Update a Benchmark.](https://docs.runloop.ai/api-reference/benchmark/update-a-benchmark.md): Update a Benchmark. Fields that are null will preserve the existing value. Fields that are provided (including empty values) will replace the existing value entirely.
- [Create and build a Blueprint.](https://docs.runloop.ai/api-reference/blueprint/create-and-build-a-blueprint.md): Starts build of custom defined container Blueprint. The Blueprint will begin in the 'provisioning' step and transition to the 'building' step once it is selected off the build queue., Upon build complete it will transition to 'building_complete' if the build is successful.
- [Create and build a Blueprint from a RepositoryConnection Inspection.](https://docs.runloop.ai/api-reference/blueprint/create-and-build-a-blueprint-from-a-repositoryconnection-inspection.md): Starts build of custom defined container Blueprint using a RepositoryConnection Inspection as a source container specification.
- [Delete a Blueprint.](https://docs.runloop.ai/api-reference/blueprint/delete-a-blueprint.md): Delete a previously created Blueprint. If a blueprint has dependent snapshots, it cannot be deleted. You can find them by querying: GET /v1/devboxes/disk_snapshots?source_blueprint_id={blueprint_id}.
- [Get a Blueprint.](https://docs.runloop.ai/api-reference/blueprint/get-a-blueprint.md): Get the details of a previously created Blueprint including the build status.
- [Get Blueprint build logs.](https://docs.runloop.ai/api-reference/blueprint/get-blueprint-build-logs.md): Get all logs from the building of a Blueprint.
- [List available blueprint metadata keys.](https://docs.runloop.ai/api-reference/blueprint/list-available-blueprint-metadata-keys.md): Returns a list of all available metadata keys that can be used for filtering blueprints.
- [List available public blueprint metadata keys.](https://docs.runloop.ai/api-reference/blueprint/list-available-public-blueprint-metadata-keys.md): Returns a list of all available metadata keys from public blueprints only that can be used for filtering.
- [List Blueprints.](https://docs.runloop.ai/api-reference/blueprint/list-blueprints.md): List all Blueprints or filter by name.
- [List Public Blueprints.](https://docs.runloop.ai/api-reference/blueprint/list-public-blueprints.md): List all public Blueprints that are available to all users.
- [List values for a specific blueprint metadata key.](https://docs.runloop.ai/api-reference/blueprint/list-values-for-a-specific-blueprint-metadata-key.md): Returns a list of all values that exist for a specific metadata key across all blueprints.
- [List values for a specific public blueprint metadata key.](https://docs.runloop.ai/api-reference/blueprint/list-values-for-a-specific-public-blueprint-metadata-key.md): Returns a list of all values that exist for a specific metadata key across all public blueprints only.
- [Preview Dockerfile definition for a Blueprint.](https://docs.runloop.ai/api-reference/blueprint/preview-dockerfile-definition-for-a-blueprint.md): Preview building a Blueprint with the specified configuration. You can take the resulting Dockerfile and test out your build using any local docker tooling.
- [Create a Browser.](https://docs.runloop.ai/api-reference/browser/create-a-browser.md): Create a Devbox that has a managed Browser and begin the boot process. As part of booting the Devbox, the browser will automatically be started with connection utilities activated.
- [Get Browser Details.](https://docs.runloop.ai/api-reference/browser/get-browser-details.md)
- [Create a Computer.](https://docs.runloop.ai/api-reference/computer/create-a-computer.md): Create a Computer and begin the boot process. The Computer will initially launch in the 'provisioning' state while Runloop allocates the necessary infrastructure. It will transition to the 'initializing' state while the booted Computer runs any Runloop or user defined set up scripts. Finally, the Computer will transition to the 'running' state when it is ready for use.
- [Get Computer Details.](https://docs.runloop.ai/api-reference/computer/get-computer-details.md)
- [Perform keyboard interaction on a Computer.](https://docs.runloop.ai/api-reference/computer/perform-keyboard-interaction-on-a-computer.md): Perform the specified keyboard interaction on the Computer identified by the given ID.
- [Perform mouse interaction on a Computer.](https://docs.runloop.ai/api-reference/computer/perform-mouse-interaction-on-a-computer.md): Perform the specified mouse interaction on the Computer identified by the given ID.
- [Perform screen interaction on a Computer.](https://docs.runloop.ai/api-reference/computer/perform-screen-interaction-on-a-computer.md): Perform the specified screen interaction on the Computer identified by the given ID.
- [Asynchronously execute a command via the Devbox shell](https://docs.runloop.ai/api-reference/devbox/asynchronously-execute-a-command-via-the-devbox-shell.md): Execute the given command in the Devbox shell asynchronously and returns the execution that can be used to track the command's progress.
- [Create a Devbox.](https://docs.runloop.ai/api-reference/devbox/create-a-devbox.md): Create a Devbox and begin the boot process. The Devbox will initially launch in the 'provisioning' state while Runloop allocates the necessary infrastructure. It will transition to the 'initializing' state while the booted Devbox runs any Runloop or user defined set up scripts. Finally, the Devbox will transition to the 'running' state when it is ready for use.
- [Create a tunnel for a running Devbox.](https://docs.runloop.ai/api-reference/devbox/create-a-tunnel-for-a-running-devbox.md): Create a V2 tunnel for an existing running Devbox. Tunnels provide encrypted URL-based access to the Devbox without exposing internal IDs. The tunnel URL format is: https://{port}-{tunnel_key}.tunnel.runloop.ai

Each Devbox can have one tunnel.
- [Create a tunnel to an available port on the Devbox.](https://docs.runloop.ai/api-reference/devbox/create-a-tunnel-to-an-available-port-on-the-devbox.md): [Deprecated] Use POST /v1/devboxes/{id}/enable_tunnel instead. This endpoint creates a legacy tunnel. The new enable_tunnel endpoint provides improved tunnel functionality with authentication options.
- [Create an SSH key for a Devbox](https://docs.runloop.ai/api-reference/devbox/create-an-ssh-key-for-a-devbox.md): Create an SSH key for a Devbox to enable remote access.
- [Delete a disk snapshot of a Devbox.](https://docs.runloop.ai/api-reference/devbox/delete-a-disk-snapshot-of-a-devbox.md): Delete a previously taken disk snapshot of a Devbox.
- [(Deprecated, please use /execute_async) Synchronously execute a shell command on a Devbox](https://docs.runloop.ai/api-reference/devbox/deprecated-please-use-execute_async-synchronously-execute-a-shell-command-on-a-devbox.md): Execute a bash command in the Devbox shell, await the command completion and return the output. Note: attach_stdin parameter is not supported for synchronous execution.
- [Download binary file contents from Devbox filesystem.](https://docs.runloop.ai/api-reference/devbox/download-binary-file-contents-from-devbox-filesystem.md): Download file contents of any type (binary, text, etc) from a specified path on the Devbox.
- [Execute a command with a known ID, optimistically waiting for completion](https://docs.runloop.ai/api-reference/devbox/execute-a-command-with-a-known-id-optimistically-waiting-for-completion.md): Execute a command with a known command ID on a devbox, optimistically waiting for it to complete within the specified timeout. If it completes in time, return the result. If not, return a status indicating the command is still running. Note: attach_stdin parameter is not supported; use execute_async for stdin support.
- [Get Devbox details.](https://docs.runloop.ai/api-reference/devbox/get-devbox-details.md): Get the latest details and status of a Devbox.
- [Get Devbox logs.](https://docs.runloop.ai/api-reference/devbox/get-devbox-logs.md): Get all logs from a running or completed Devbox.
- [Get resource usage for a Devbox.](https://docs.runloop.ai/api-reference/devbox/get-resource-usage-for-a-devbox.md): Get resource usage metrics for a specific Devbox. Returns CPU, memory, and disk consumption calculated from the Devbox's lifecycle, excluding any suspended periods for CPU and memory. Disk usage includes the full elapsed time since storage is consumed even when suspended.
- [Get status of an asynchronous execution on a Devbox.](https://docs.runloop.ai/api-reference/devbox/get-status-of-an-asynchronous-execution-on-a-devbox.md): Get the latest status of a previously launched asynchronous execuction including stdout/error and the exit code if complete.
- [Kill an asynchronous execution currently running on a devbox](https://docs.runloop.ai/api-reference/devbox/kill-an-asynchronous-execution-currently-running-on-a-devbox.md): Kill a previously launched asynchronous execution if it is still running by killing the launched process. Optionally kill the entire process group.
- [List available devbox metadata keys.](https://docs.runloop.ai/api-reference/devbox/list-available-devbox-metadata-keys.md): Returns a list of all available metadata keys that can be used for filtering devboxes.
- [List available public snapshot metadata keys.](https://docs.runloop.ai/api-reference/devbox/list-available-public-snapshot-metadata-keys.md): Returns a list of all available metadata keys from public snapshots only that can be used for filtering.
- [List available snapshot metadata keys.](https://docs.runloop.ai/api-reference/devbox/list-available-snapshot-metadata-keys.md): Returns a list of all available metadata keys that can be used for filtering snapshots.
- [List Devboxes.](https://docs.runloop.ai/api-reference/devbox/list-devboxes.md): List all Devboxes while optionally filtering by status.
- [List disk snapshots of a Devbox.](https://docs.runloop.ai/api-reference/devbox/list-disk-snapshots-of-a-devbox.md): List all snapshots of a Devbox while optionally filtering by Devbox ID, source Blueprint ID, and metadata.
- [List public disk snapshots.](https://docs.runloop.ai/api-reference/devbox/list-public-disk-snapshots.md): List all public disk snapshots that are available to all users.
- [List values for a specific devbox metadata key.](https://docs.runloop.ai/api-reference/devbox/list-values-for-a-specific-devbox-metadata-key.md): Returns a list of all values that exist for a specific metadata key across all devboxes.
- [List values for a specific public snapshot metadata key.](https://docs.runloop.ai/api-reference/devbox/list-values-for-a-specific-public-snapshot-metadata-key.md): Returns a list of all values that exist for a specific metadata key across all public snapshots only.
- [List values for a specific snapshot metadata key.](https://docs.runloop.ai/api-reference/devbox/list-values-for-a-specific-snapshot-metadata-key.md): Returns a list of all values that exist for a specific metadata key across all snapshots.
- [Live Tail Devbox Logs.](https://docs.runloop.ai/api-reference/devbox/live-tail-devbox-logs.md): Tail the logs for the given devbox. This will return past log entries and continue streaming from there. The stream will then continue to stream logs until the connection is closed.
- [Query the status of an asynchronous disk snapshot.](https://docs.runloop.ai/api-reference/devbox/query-the-status-of-an-asynchronous-disk-snapshot.md): Get the current status of an asynchronous disk snapshot operation, including whether it is still in progress and any error messages if it failed.
- [Read text file contents from Devbox filesystem.](https://docs.runloop.ai/api-reference/devbox/read-text-file-contents-from-devbox-filesystem.md): Read file contents from a file on a Devbox as a UTF-8. Note 'downloadFile' should be used for large files (greater than 100MB). Returns the file contents as a UTF-8 string.
- [Remove an open tunnel on the Devbox.](https://docs.runloop.ai/api-reference/devbox/remove-an-open-tunnel-on-the-devbox.md): [Deprecated] Tunnels remain active until devbox is shutdown. This endpoint removes a legacy tunnel.
- [Reset the idle timer of a running Devbox.](https://docs.runloop.ai/api-reference/devbox/reset-the-idle-timer-of-a-running-devbox.md): Send a 'Keep Alive' signal to a running Devbox that is configured to shutdown on idle so the idle time resets.
- [Resume a suspended Devbox](https://docs.runloop.ai/api-reference/devbox/resume-a-suspended-devbox.md): Resume a suspended Devbox with the disk state captured as suspend time. Note that any previously running processes or daemons will need to be restarted using the Devbox shell tools.
- [Send Content to Std In for a running execution.](https://docs.runloop.ai/api-reference/devbox/send-content-to-std-in-for-a-running-execution.md): Send content to the Std In of a running execution.
- [Shutdown a running Devbox.](https://docs.runloop.ai/api-reference/devbox/shutdown-a-running-devbox.md): Shutdown a running Devbox. This will permanently stop the Devbox. If you want to save the state of the Devbox, you should take a snapshot before shutting down or should suspend the Devbox instead of shutting down.
- [Start an asynchronous disk snapshot of a running Devbox.](https://docs.runloop.ai/api-reference/devbox/start-an-asynchronous-disk-snapshot-of-a-running-devbox.md): Start an asynchronous disk snapshot of a devbox with the specified name and metadata. The snapshot operation will continue in the background and can be monitored using the query endpoint.
- [Suspend a running Devbox](https://docs.runloop.ai/api-reference/devbox/suspend-a-running-devbox.md): Suspend a running Devbox and create a disk snapshot to enable resuming the Devbox later with the same disk. Note this will not snapshot memory state such as running processes.
- [Synchronously create a disk snapshot of a running Devbox.](https://docs.runloop.ai/api-reference/devbox/synchronously-create-a-disk-snapshot-of-a-running-devbox.md): Create a disk snapshot of a devbox with the specified name and metadata to enable launching future Devboxes with the same disk state.
- [Update a Devbox.](https://docs.runloop.ai/api-reference/devbox/update-a-devbox.md): Updates a devbox by doing a complete update the existing name,metadata fields. It does not patch partial values.
- [Update metadata of Disk Snapshot.](https://docs.runloop.ai/api-reference/devbox/update-metadata-of-disk-snapshot.md): Updates disk snapshot metadata via update vs patch. The entire metadata will be replaced.
- [Upload binary file contents to Devbox filesystem.](https://docs.runloop.ai/api-reference/devbox/upload-binary-file-contents-to-devbox-filesystem.md): Upload file contents of any type (binary, text, etc) to a Devbox. Note this API is suitable for large files (larger than 100MB) and efficiently uploads files via multipart form data.
- [Wait for a Devbox to reach one of the specified statuses.](https://docs.runloop.ai/api-reference/devbox/wait-for-a-devbox-to-reach-one-of-the-specified-statuses.md): Polls the Devbox's status until it reaches one of the desired statuses or times out.
- [Wait for an asynchronous execution to reach a specific status.](https://docs.runloop.ai/api-reference/devbox/wait-for-an-asynchronous-execution-to-reach-a-specific-status.md): Polls the asynchronous execution's status until it reaches one of the desired statuses or times out. Max is 25 seconds.
- [Write text file contents to Devbox filesystem.](https://docs.runloop.ai/api-reference/devbox/write-text-file-contents-to-devbox-filesystem.md): Write UTF-8 string contents to a file at path on the Devbox. Note for large files (larger than 100MB), the upload_file endpoint must be used.
- [Tails the stderr logs for the given execution with SSE streaming](https://docs.runloop.ai/api-reference/executions/tails-the-stderr-logs-for-the-given-execution-with-sse-streaming.md): Tails the stderr logs for the given execution with SSE streaming
- [Tails the stdout logs for the given execution with SSE streaming](https://docs.runloop.ai/api-reference/executions/tails-the-stdout-logs-for-the-given-execution-with-sse-streaming.md): Tails the stdout logs for the given execution with SSE streaming
- [[Beta] Create a GatewayConfig.](https://docs.runloop.ai/api-reference/gateway-configs/[beta]-create-a-gatewayconfig.md): [Beta] Create a new GatewayConfig to proxy API requests through the credential gateway. The config specifies the target endpoint and how credentials should be applied.
- [[Beta] Delete a GatewayConfig.](https://docs.runloop.ai/api-reference/gateway-configs/[beta]-delete-a-gatewayconfig.md): [Beta] Delete an existing GatewayConfig. This action is irreversible.
- [[Beta] Get a GatewayConfig.](https://docs.runloop.ai/api-reference/gateway-configs/[beta]-get-a-gatewayconfig.md): [Beta] Get a specific GatewayConfig by its unique identifier.
- [[Beta] List GatewayConfigs.](https://docs.runloop.ai/api-reference/gateway-configs/[beta]-list-gatewayconfigs.md): [Beta] List all GatewayConfigs for the authenticated account, including system-provided configs like 'anthropic' and 'openai'.
- [[Beta] Update a GatewayConfig.](https://docs.runloop.ai/api-reference/gateway-configs/[beta]-update-a-gatewayconfig.md): [Beta] Update an existing GatewayConfig. All fields are optional.
- [[Beta] Create an McpConfig.](https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig.md): [Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.
- [[Beta] Delete an McpConfig.](https://docs.runloop.ai/api-reference/mcp-configs/[beta]-delete-an-mcpconfig.md): [Beta] Delete an existing McpConfig. This action is irreversible.
- [[Beta] Get an McpConfig.](https://docs.runloop.ai/api-reference/mcp-configs/[beta]-get-an-mcpconfig.md): [Beta] Get a specific McpConfig by its unique identifier.
- [[Beta] List McpConfigs.](https://docs.runloop.ai/api-reference/mcp-configs/[beta]-list-mcpconfigs.md): [Beta] List all McpConfigs for the authenticated account.
- [[Beta] Update an McpConfig.](https://docs.runloop.ai/api-reference/mcp-configs/[beta]-update-an-mcpconfig.md): [Beta] Update an existing McpConfig. All fields are optional.
- [Create a NetworkPolicy.](https://docs.runloop.ai/api-reference/network-policies/create-a-networkpolicy.md): Create a new NetworkPolicy with the specified egress rules. The policy can then be applied to blueprints, devboxes, or snapshot resumes.
- [Delete a NetworkPolicy.](https://docs.runloop.ai/api-reference/network-policies/delete-a-networkpolicy.md): Delete an existing NetworkPolicy. This action is irreversible.
- [Get a NetworkPolicy.](https://docs.runloop.ai/api-reference/network-policies/get-a-networkpolicy.md): Get a specific NetworkPolicy by its unique identifier.
- [List NetworkPolicies.](https://docs.runloop.ai/api-reference/network-policies/list-networkpolicies.md): List all NetworkPolicies for the authenticated account.
- [Update a NetworkPolicy.](https://docs.runloop.ai/api-reference/network-policies/update-a-networkpolicy.md): Update an existing NetworkPolicy. All fields are optional.
- [Complete Object Upload.](https://docs.runloop.ai/api-reference/objects/complete-object-upload.md): Mark an Object's upload as complete, transitioning it from UPLOADING to READ-only state.
- [Create an Object.](https://docs.runloop.ai/api-reference/objects/create-an-object.md): Create a new Object with content and metadata. The Object will be assigned a unique ID.
- [Delete an Object.](https://docs.runloop.ai/api-reference/objects/delete-an-object.md): Delete an existing Object by ID. This action is irreversible and will remove the Object and all its metadata.
- [Generate Download URL for Object.](https://docs.runloop.ai/api-reference/objects/generate-download-url-for-object.md): Generate a presigned download URL for an Object. The URL will be valid for the specified duration.
- [Get an Object.](https://docs.runloop.ai/api-reference/objects/get-an-object.md): Retrieve a specific Object by its unique identifier.
- [List Objects.](https://docs.runloop.ai/api-reference/objects/list-objects.md): List all Objects for the authenticated account with pagination support.
- [List Public Objects.](https://docs.runloop.ai/api-reference/objects/list-public-objects.md): List all public Objects with pagination support.
- [Add user-defined manifest to repository inspection.](https://docs.runloop.ai/api-reference/repository/add-user-defined-manifest-to-repository-inspection.md): Create and save a user-defined repository manifest to the latest inspection.
- [Create a Repository Connection.](https://docs.runloop.ai/api-reference/repository/create-a-repository-connection.md): Create a connection to a Github Repository and trigger an initial inspection of the repo's technical stack and developer environment requirements.
- [Delete a Repository Connection and associated objects.](https://docs.runloop.ai/api-reference/repository/delete-a-repository-connection-and-associated-objects.md): Permanently Delete a Repository Connection including any automatically generated inspection insights.
- [Get Repository Connection details.](https://docs.runloop.ai/api-reference/repository/get-repository-connection-details.md): Get Repository Connection details including latest inspection status and generated repository insights.
- [Get repository inspection.](https://docs.runloop.ai/api-reference/repository/get-repository-inspection.md): Get a repository inspection by id.
- [List available repository connections.](https://docs.runloop.ai/api-reference/repository/list-available-repository-connections.md): List all available repository connections.
- [List repository inspections.](https://docs.runloop.ai/api-reference/repository/list-repository-inspections.md): List all inspections of a repository connection including automatically generated insights for each inspection.
- [Refresh a repository connection.](https://docs.runloop.ai/api-reference/repository/refresh-a-repository-connection.md): Refresh a repository connection by inspecting the latest version including repo's technical stack and developer environment requirements.
- [Trigger an inspection against given repository connection.](https://docs.runloop.ai/api-reference/repository/trigger-an-inspection-against-given-repository-connection.md): Inspect a repository connection by inspecting the specified version including repo's technical stack and developer environment requirements.
- [Cancel a Scenario run.](https://docs.runloop.ai/api-reference/scenario/cancel-a-scenario-run.md): Cancel a currently running Scenario run. This will shutdown the underlying Devbox resource.
- [Complete a ScenarioRun.](https://docs.runloop.ai/api-reference/scenario/complete-a-scenariorun.md): Complete a currently running ScenarioRun. Calling complete will shutdown underlying Devbox resource.
- [Create a custom scenario scorer.](https://docs.runloop.ai/api-reference/scenario/create-a-custom-scenario-scorer.md): Create a custom scenario scorer.
- [Create a Scenario.](https://docs.runloop.ai/api-reference/scenario/create-a-scenario.md): Create a Scenario, a repeatable AI coding evaluation test that defines the starting environment as well as evaluation success criteria.
- [Download logs for a Scenario run.](https://docs.runloop.ai/api-reference/scenario/download-logs-for-a-scenario-run.md): Download a zip file containing all logs for a Scenario run from the associated devbox.
- [Get a previously created ScenarioRun.](https://docs.runloop.ai/api-reference/scenario/get-a-previously-created-scenariorun.md): Get a ScenarioRun given ID.
- [Get a Scenario.](https://docs.runloop.ai/api-reference/scenario/get-a-scenario.md): Get a previously created scenario.
- [Get the runs for a Scenario.](https://docs.runloop.ai/api-reference/scenario/get-the-runs-for-a-scenario.md): Get a previously created scenario.
- [List available scenario metadata keys.](https://docs.runloop.ai/api-reference/scenario/list-available-scenario-metadata-keys.md): Returns a list of all available metadata keys that can be used for filtering scenarios.
- [List Public Scenarios.](https://docs.runloop.ai/api-reference/scenario/list-public-scenarios.md): List all public scenarios matching filter.
- [List Scenario Scorers.](https://docs.runloop.ai/api-reference/scenario/list-scenario-scorers.md): List all Scenario Scorers matching filter.
- [List ScenarioRuns.](https://docs.runloop.ai/api-reference/scenario/list-scenarioruns.md): List all ScenarioRuns matching filter.
- [List Scenarios.](https://docs.runloop.ai/api-reference/scenario/list-scenarios.md): List all Scenarios matching filter.
- [List values for a specific scenario metadata key.](https://docs.runloop.ai/api-reference/scenario/list-values-for-a-specific-scenario-metadata-key.md): Returns a list of all values that exist for a specific metadata key across all scenarios.
- [Retrieve Scenario Scorer.](https://docs.runloop.ai/api-reference/scenario/retrieve-scenario-scorer.md): Retrieve Scenario Scorer.
- [Score a ScenarioRun.](https://docs.runloop.ai/api-reference/scenario/score-a-scenariorun.md): Score a currently running ScenarioRun.
- [Start a new ScenarioRun.](https://docs.runloop.ai/api-reference/scenario/start-a-new-scenariorun.md): Start a new ScenarioRun based on the provided Scenario.
- [Update a custom scenario scorer.](https://docs.runloop.ai/api-reference/scenario/update-a-custom-scenario-scorer.md): Update a scenario scorer.
- [Update a Scenario.](https://docs.runloop.ai/api-reference/scenario/update-a-scenario.md): Update a Scenario. Fields that are null will preserve the existing value. Fields that are provided (including empty values) will replace the existing value entirely.
- [Create a Secret.](https://docs.runloop.ai/api-reference/secrets/create-a-secret.md): Create a new Secret with a globally unique name and value. The Secret will be encrypted at rest and made available as an environment variable in Devboxes.
- [Delete a Secret.](https://docs.runloop.ai/api-reference/secrets/delete-a-secret.md): Delete an existing Secret by name. This action is irreversible and will remove the Secret from all Devboxes.
- [List Secrets.](https://docs.runloop.ai/api-reference/secrets/list-secrets.md): List all Secrets for the authenticated account. Secret values are not included for security reasons.
- [Update a Secret.](https://docs.runloop.ai/api-reference/secrets/update-a-secret.md): Update the value of an existing Secret by name. The new value will be encrypted at rest.
- [Creating Scenarios](https://docs.runloop.ai/docs/benchmarks/creating-scenarios.md): Learn how to create, configure, and run scenarios in Runloop.
- [Build Custom Agent Benchmarks with Runloop](https://docs.runloop.ai/docs/benchmarks/custom-benchmarks.md): Learn how to create and run custom benchmarks
- [Scorers](https://docs.runloop.ai/docs/benchmarks/custom-scorers.md): Learn how to create and customize scoring functions.
- [Overview of Benchmarks & Scenarios on Runloop](https://docs.runloop.ai/docs/benchmarks/overview.md): Make your agent better and more reliable with Runloop's tools for benchmarking.
- [Public Benchmarks](https://docs.runloop.ai/docs/benchmarks/public-benchmarks.md): Run your agent against popular public benchmarks.
- [Deploying Agents with GitHub Actions](https://docs.runloop.ai/docs/devboxes/agents/deploying-with-github-actions.md): Automate agent deployment using the Runloop deploy-agent GitHub Action
- [Using the Agents API](https://docs.runloop.ai/docs/devboxes/agents/using-agents-api.md): Create and manage agents on Runloop
- [AI Gateways](https://docs.runloop.ai/docs/devboxes/ai-gateways.md): Securely proxy AI API requests without exposing credentials to your agents
- [Dockerfile Customization](https://docs.runloop.ai/docs/devboxes/blueprints/dockerfile-customization.md): Create Blueprints using custom Dockerfiles, public registries, secrets, and composable blueprints
- [Files and Build Context](https://docs.runloop.ai/docs/devboxes/blueprints/files-and-mounts.md): Add files, code repositories, and build contexts to your Blueprints
- [Blueprint Lifecycle](https://docs.runloop.ai/docs/devboxes/blueprints/lifecycle.md): Manage blueprint launch parameters, deletion, and cleanup
- [Network Policies for Blueprints](https://docs.runloop.ai/docs/devboxes/blueprints/network-policies.md): Restrict network access during blueprint builds and for Devboxes created from blueprints
- [Blueprints Overview](https://docs.runloop.ai/docs/devboxes/blueprints/overview.md): Template images for optimized Devbox startup
- [Quickstart - Controlling a Browser in a Runloop Devbox](https://docs.runloop.ai/docs/devboxes/capabilities/browser.md): Learn how to control a browser programmatically inside a Runloop Devbox using the Runloop SDK
- [Quickstart - Controlling a remote computer in a Runloop Devbox](https://docs.runloop.ai/docs/devboxes/capabilities/computer.md): Learn how to control a computer programmatically inside a Runloop Devbox using the Runloop SDK
- [Running Docker on a Devbox](https://docs.runloop.ai/docs/devboxes/capabilities/docker-in-docker.md): Run Docker on a Devbox (Docker-in-Docker)
- [Managing Account Secrets](https://docs.runloop.ai/docs/devboxes/configuration/account-secrets.md): Securely manage API keys, tokens, and other sensitive configuration data at the account level
- [Configuring your bash environment](https://docs.runloop.ai/docs/devboxes/configuration/bash-profile-environment-setup.md): Configuring the bash environment on your devboxes
- [Configuring your devbox architecture](https://docs.runloop.ai/docs/devboxes/configuration/devbox-architecture.md): Configuring the architecture on launched devboxes
- [Managing Devbox Metadata](https://docs.runloop.ai/docs/devboxes/configuration/metadata.md): Effectively manage and organize large numbers of Devboxes using metadata
- [Configuring Devbox Instance Sizes](https://docs.runloop.ai/docs/devboxes/configuration/sizes.md): Configure your Devboxes using predefined sizes
- [Debugging Agents with rl-cli](https://docs.runloop.ai/docs/devboxes/configuration/troubleshooting/debugging-agent-output-with-ssh.md): Securely connect to a remote Runloop Devbox using SSH for debugging
- [Troubleshooting Blueprint Builds](https://docs.runloop.ai/docs/devboxes/configuration/troubleshooting/troubleshooting-blueprints.md): Debug and fix your Blueprint builds in Runloop.
- [Configuring your devbox user profile](https://docs.runloop.ai/docs/devboxes/configuration/user-parameters.md): Custom users for your devboxes
- [Execute Commands on a Devbox](https://docs.runloop.ai/docs/devboxes/execute-commands.md): Run and execute code at scale
- [Execution Logs](https://docs.runloop.ai/docs/devboxes/execution-logs.md): Stream logs in real-time or retrieve logs from completed executions
- [Read and Write Files on a Devbox](https://docs.runloop.ai/docs/devboxes/files.md): Give your AI agent access to modify and interact with files on your devbox.
- [The Devbox Lifecycle](https://docs.runloop.ai/docs/devboxes/lifecycle.md): Understand the stages of the Devbox lifecycle.
- [Mount AI Agents](https://docs.runloop.ai/docs/devboxes/mounts/agent-mounts.md): Mount pre-configured AI agents to your Devboxes
- [Mount a Code Repository on a Devbox](https://docs.runloop.ai/docs/devboxes/mounts/code-mounts.md): Enable AI agents to work with full projects: access public and private repositories
- [Mount Files Inline](https://docs.runloop.ai/docs/devboxes/mounts/file-mounts.md): Inject file content directly into your Devbox at creation time
- [Mount Storage Objects](https://docs.runloop.ai/docs/devboxes/mounts/object-mounts.md): Mount files and data objects to your Devboxes
- [Mounts Overview](https://docs.runloop.ai/docs/devboxes/mounts/overview.md): Mount code repositories, files, objects, and agents to your Devboxes
- [Named Shells](https://docs.runloop.ai/docs/devboxes/named-shells.md): Use stateful named shells to maintain environment and working directory across commands
- [Devbox Overview](https://docs.runloop.ai/docs/devboxes/overview.md): Devbox: the Runloop Sandbox Environment
- [Repo Connect - Automatic Devbox Setup from a Github Repository](https://docs.runloop.ai/docs/devboxes/repo-connect.md): Automatic devbox setup from a GitHub repository. Intelligent discovery of build commands, dependencies, and project structure
- [Devbox Snapshots](https://docs.runloop.ai/docs/devboxes/snapshots.md): Saved diskstates from existing for devboxes for re-use & branching
- [Devbox Lifetime Management](https://docs.runloop.ai/docs/devboxes/start-stop.md): Control devbox automatic shutdown and idle behaviors
- [Open a Tunnel to a Service on a devbox](https://docs.runloop.ai/docs/devboxes/tunnels.md): Create a tunnel to access ports on your devbox
- [Network Policies](https://docs.runloop.ai/docs/network-policies.md): Control egress network access for your Devboxes
- [Runloop Changelog](https://docs.runloop.ai/docs/overview/release-notes.md): Latest updates and improvements to Runloop
- [Runloop Features](https://docs.runloop.ai/docs/overview/runloop-features.md): Summary of Key Runloop Platform Features
- [What is Runloop?](https://docs.runloop.ai/docs/overview/what-is-runloop.md): Runloop: Sandbox Tools for AI Agent Workflows
- [Storage Objects](https://docs.runloop.ai/docs/storage-objects/overview.md): Store and manage files and data objects for integration with Devboxes and Blueprints
- [Support for AI tools](https://docs.runloop.ai/docs/tools/ai-tools.md): Add context about the Runloop API to your LLMs
- [Cursor Rules](https://docs.runloop.ai/docs/tools/cursor-files.md)
- [Runloop Dashboard](https://docs.runloop.ai/docs/tools/dashboard.md): Manage, monitor, and optimize your AI-powered coding environments with the Runloop Dashboard.
- [Runloop CLI](https://docs.runloop.ai/docs/tools/rl-cli.md): Explore, experiment with, and test the Runloop API using the Runloop CLI.
- [SDKs](https://docs.runloop.ai/docs/tools/sdks.md): Use the Runloop SDKs to interact with the Runloop API.
- [Quickstart](https://docs.runloop.ai/docs/tutorials/quickstart.md): Create your first Runloop Devbox in under a minute.
- [Running Agents on Sandboxes](https://docs.runloop.ai/docs/tutorials/running-agents-on-sandboxes.md): Empower your agents to run code inside a devbox.
- [Share a Live Preview](https://docs.runloop.ai/docs/tutorials/running-agents-on-sandboxes/share-live-preview.md): Start your app and share a live preview link in pull requests using devbox tunnels.
- [Suspend and Resume Workflow](https://docs.runloop.ai/docs/tutorials/running-agents-on-sandboxes/suspend-resume-workflow.md): Suspend your devbox to preserve state, wait for PR feedback, and resume to continue working iteratively.
- [Turn-Based Interaction with Agent](https://docs.runloop.ai/docs/tutorials/running-agents-on-sandboxes/turn-based-interaction.md): Create a turn-based workflow where the agent updates a GitHub PR with progress and responds to PR comments as prompts.