How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Runloop

Runloop Devbox-Lifecycle API

The Devbox-Lifecycle API from Runloop — 7 operation(s) for devbox-lifecycle.

Documentation Provider Profile APIs.io OpenAPI GitHub

Runloop Devbox-Lifecycle API is one of 24 APIs that Runloop publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 19 JSON Schema definitions.

Tagged areas include Devbox-Lifecycle. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 19 JSON Schemas.

This API exposes 8 operations across 7 paths, and defines 36 schemas. It is described by OpenAPI 3.2.0, at version 0.1.

Requests are made against a single base URL, https://api.runloop.ai.

8 operations 7 paths 36 schemas 1 GET7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1
Base URL
https://api.runloop.ai
Authentication
HTTP Bearer
Contact
Runloop AI Support
Resource Areas
1

Authentication & Security 1

Runloop Devbox-Lifecycle API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 8

Across 7 paths, the API surfaces 8 operations — 1 GET, 7 POST. Each is listed below with its method, path, parameters, and response codes.

Devbox-Lifecycle 8
POST
/v1/devboxes
Create a Devbox.
createDevbox body → 200
POST
/v1/devboxes/{id}
Update a Devbox.
updateDevbox 1 param body → 200
GET
/v1/devboxes/{id}
Get Devbox details.
getDevbox 1 param → 200
POST
/v1/devboxes/{id}/keep_alive
Reset the idle timer of a running Devbox.
keepAliveDevbox 1 param → 200
POST
/v1/devboxes/{id}/resume
Resume a suspended Devbox
resumeDevbox 1 param → 200400404
POST
/v1/devboxes/{id}/shutdown
Shutdown a running Devbox.
shutdownDevbox 2 params → 200409
POST
/v1/devboxes/{id}/suspend
Suspend a running Devbox
suspendDevbox 1 param → 200400404
POST
/v1/devboxes/{id}/wait_for_status
Wait for a Devbox to reach one of the specified statuses.
waitForDevboxStatus 1 param body → 200400404408

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are DevboxView (18 properties), DevboxCreateParameters (16 properties), LaunchParameters (13 properties), CodeMount (6 properties). Each schema is shown below with its type and property counts.

DevboxViewStatus
string
The status of the Devbox. provisioning: Runloop is allocating and booting the necessary infrastructure resources. initializing: Runloop defined boot scripts ar…
DevboxViewFailureReason
string
The category of failure experienced by the Devbox. outofmemory: The Devbox ran out of memory at runtime. Use launch parameters to request a larger resource siz…
BrokerMount
object
6 properties 2 required
LaunchParameters
object
LaunchParameters enable you to customize the resources available to your Devbox as well as the environment set up that should be completed before the Devbox is…
13 properties
McpSpecView
object
2 properties 2 required
FileMount
object
3 properties 3 required
GatewaySpec
object
GatewaySpec links an agent gateway configuration to a secret for credential proxying in a devbox. The agent gateway will proxy requests to external APIs using…
2 properties 2 required
LifecycleConfigurationParameters
object
Lifecycle configuration for Devbox idle and resume behavior. Configure idle policy via afteridle and resume triggers via resumetriggers.
2 properties
TunnelAuthModeView
string
AgentMount
object
5 properties 3 required
IdleConfigurationParameters
object
2 properties 2 required
Number
object
CodeMount
object
6 properties 3 required
EmptyRecord
object
Mount
TunnelConfig
object
Configuration for creating a V2 tunnel. When specified at Devbox creation, a tunnel will be automatically provisioned.
3 properties
GatewaySpecView
object
2 properties 2 required
TunnelAuthMode
string
DevboxWaitForStatusRequest
object
2 properties 1 required
DevboxCapabilities
string
InitiatorType
string
IdleAction
string
Action to take after Devbox idle timer is triggered. shutdown: Shutdown the Devbox. suspend: Suspend the Devbox.
DevboxCreateParameters
object
16 properties
DevboxViewShutdownReason
string
The reason that caused the transition of the Devbox to the shutown state. apishutdown: The Devbox shutdown due to API request. entrypointexit: The Devbox entry…
McpSpec
object
[Beta] McpSpec links an MCP configuration to a secret for MCP server access in a devbox. The MCP hub will proxy requests to upstream MCP servers using the spec…
2 properties 2 required
CodeMountParameters
object
5 properties 2 required
DevboxView
object
A Devbox represents a virtual development environment. It is an isolated sandbox that can be given to agents and used to run arbitrary code such as AI generate…
18 properties 8 required
BrokerMountProtocol
string
DevboxStateTransition
object
2 properties
UserParameters
object
Configuration for the Linux user in the Devbox environment.
2 properties 2 required
Architecture
string
TunnelView
object
A V2 tunnel provides secure HTTP access to services running on a Devbox. Tunnels allow external clients to reach web servers, APIs, or other HTTP services runn…
6 properties 5 required
ResumeTriggers
object
Triggers that can resume a suspended Devbox.
2 properties
DevboxUpdateParameters
object
2 properties
ResourceSize
string
The size of the Devbox resources for Runloop to allocate. XSMALL: 0.5 cpu x 1GiB memory x 4GiB disk SMALL: 1 cpu x 2GiB memory x 4GiB disk MEDIUM: 2 cpu x 4GiB…
ObjectMount
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

runloop-ai-devbox-lifecycle-api-openapi.yml Raw ↑

Other APIs Runloop publishes across the network.

Runloop agents API
AE Profile APIs.io
Runloop apikeys API
AE Profile APIs.io
Runloop axons API
AE Profile APIs.io
Runloop Benchmark API
AE Profile APIs.io
Runloop Blueprint API
AE Profile APIs.io
Runloop Blueprint-Lifecycle API
AE Profile APIs.io
Runloop Blueprint-ObservabilityTools API
AE Profile APIs.io
Runloop Devbox API
AE Profile APIs.io
Runloop Devbox-FileTools API
AE Profile APIs.io
Runloop Devbox-NetworkTools API
AE Profile APIs.io
Runloop Devbox-ObservabilityTools API
AE Profile APIs.io
Runloop Devbox-PersistenceTools API
AE Profile APIs.io
#Devbox-Lifecycle
← Back to R APIs
API Details
ID
runloop-ai:runloop-ai-devbox-lifecycle-api
Base URL
https://api.runloop.ai
Docs
https://docs.runloop.ai/docs/devboxes/overview
Provider
Runloop
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=runloop-ai-devbox-lifecycle-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/runloop-ai-devbox-lifecycle-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Runloop Devbox-Lifecycle API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.