Wildflower Computer
Open console
Browse Documentation

Wildflower Documentation

Search the contract.

Search human guides and generated API references from one index.

View as MarkdownOpen this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in CursorSend this page to Cursor chatDownload OpenAPIUse the machine-readable contract

Reference / generated from OpenAPI

The contract, in full bloom.

Browse every public operation, model, and provider capability generated from the same contract as the TypeScript, Python, Rust, Go, and Zig SDKs. The pages are static, content-addressed, and tied to OpenAPI 0.8.0.

8operations
51models
34error codes
5SDK targets
12providers

Browser control plane

The account console uses 36 separately generated, cookie-authenticated operations. They are documented without presenting them as public project-key SDK methods.

Browse the generated browser control-plane reference →

Operations

Resource

sandboxes

GET/v1/sandboxesList project sandboxesPOST/v1/sandboxesCreate a persistent running sandboxGET/v1/sandboxes/{id}Get a sandboxPOST/v1/sandboxes/{id}/execRun a command in an existing sandboxPOST/v1/sandboxes/{id}/files/readRead a file from an existing sandboxPOST/v1/sandboxes/{id}/files/writeWrite a file in an existing sandboxDELETE/v1/sandboxes/{id}Delete a sandbox

Resource

providers

GET/v1/providersList provider capabilities

Models

Public request and response models preserve requiredness, nullability, enums, discriminated unions, and field descriptions from the generator IR.

enumProvider

Stable provider identifier used for creation, routing, capability discovery, and errors.

enumImageMode

How a provider selects or fixes the sandbox runtime image.

enumTimeoutMode

Whether sandbox lifetime is configured in seconds or managed entirely by the provider.

enumOutputStreams

Whether the provider preserves stdout and stderr separately or returns combined command output.

objectProviderPricingProfile

Versioned workload used to compare published provider prices without implying an invoice quote.

objectProviderPricing

Official provider pricing evidence and, when published rates permit it, a normalized catalog comparison.

objectProviderCapabilities

Discovery entry with identity, official pricing evidence, and runtime behavior for one configured sandbox provider.

objectProviderCatalog

Identity, pricing evidence, and capability catalog for every provider configured in this Wildflower build.

objectProviderProfileConnection

Non-secret provider-specific routing context stored with or supplied alongside a provider credential.

objectProviderProfileInput

Credential and optional non-secret connection context used to connect one project-scoped provider profile.

enumProviderProfilePersistence

Storage boundary currently protecting a connected provider profile.

enumProviderOperation

Provider operation whose credential entitlement or evidence was evaluated.

enumProviderOperationStatus

Current evidence state for one provider operation.

enumProviderProfileStatus

Overall provider profile readiness derived from the required operation matrix.

enumProviderTestMode

Whether the result came from a non-mutating safe check or a provider-mutating deep verification.

objectProviderOperationReadiness

Evidence, failure reason, and remediation for one provider operation.

objectProviderProfileReadiness

Persisted operation-level readiness for a connected provider profile.

objectProviderProfile

Redacted metadata for a connected project-scoped provider profile.

objectProviderProfileCatalog

Redacted project-scoped provider profiles visible to the authenticated project.

objectProviderProfileTest

Safe or deep provider profile result with per-operation evidence and cleanup state.

objectDeepProviderProfileTestInput

Explicit acknowledgement required before a provider-mutating deep verification.

enumSandboxStatus

Provider-neutral sandbox lifecycle state observed by Wildflower Computer.

unionCreateSandboxRequest

Provider-discriminated input for creating one persistent sandbox.

objectAgentcoreCreateSandboxRequest

AgentCore is a capability-limited, non-resumable session provider reached through the Wildflower Computer bridge.

objectBlaxelCreateSandboxRequest

Blaxel requires workspace context in either the connected profile or an inline X-Provider-Workspace override.

objectBoxCreateSandboxRequest

Box creates a fixed Ubuntu VM without injecting account-level Box secrets and permanently removes it on delete.

objectCloudflareCreateSandboxRequest

Cloudflare uses the customer-deployed official Sandbox Bridge. Image and timeout selection are configured in that Worker.

objectE2bCreateSandboxRequest

E2B creation input using an optional template and sandbox lifetime.

objectNovitaCreateSandboxRequest

Novita Agent Sandbox creation input using an optional template and sandbox lifetime.

objectDaytonaCreateSandboxRequest

Daytona creation input using an optional container image and rounded TTL.

objectModalCreateSandboxRequest

Modal uses the customer-owned Wildflower Computer provider bridge and the official Modal SDK.

objectSpritesCreateSandboxRequest

Sprites provides a fixed environment, sleeps automatically, and persists until deleted.

objectRunloopCreateSandboxRequest

Runloop Devboxes use the direct REST API and are shut down permanently on delete.

objectSmolCreateSandboxRequest

Smol Cloud creates a persistent hardware-isolated microVM with blocked network egress; the first command automatically starts it.

objectVercelCreateSandboxRequest

Wildflower Computer creates Vercel sandboxes with persistence enabled and permanently deletes them on delete.

objectSandboxMetadata

Provider provenance and logical operation metadata associated with a sandbox.

objectSandbox

Current normalized state of one provider-backed persistent sandbox.

objectSandboxListItem

Project registry record for a sandbox, including cached status timestamps and deletion history.

objectSandboxPage

Cursor-paginated page of project sandbox registry records.

intersectionDeletedSandbox

Sandbox response whose normalized state is permanently deleted.

objectRunCommandInput

Bounded command, working directory, and environment executed in an existing sandbox.

objectCommandResult

Normalized command output and process exit code from an existing sandbox.

enumFileEncoding

Wire encoding for bounded file content.

objectReadFileInput

Path and requested encoding for reading one bounded sandbox file.

objectReadFileResult

Bounded file content read from an existing sandbox.

objectWriteFileInput

Path, content, and encoding for writing one bounded sandbox file.

objectWriteFileResult

Result of writing one bounded file into an existing sandbox.

enumErrorCode

Stable Wildflower Computer error code set, version 3.

objectError

Normalized API failure safe to expose to SDK callers.

objectErrorEnvelope

JSON envelope returned for every API failure.

objectHealth

Service liveness and optional build provenance.

Provider capabilities

Generated provider pages show typed create options and non-secret connection context without copying credentials into the documentation bundle.

1 create fieldsAWS AgentCore

1 typed connection field.

2 create fieldsBlaxel

1 typed connection field.

1 create fieldsASCII Box

No additional connection context.

0 create fieldsCloudflare Sandbox

1 typed connection field.

2 create fieldsE2B

No additional connection context.

2 create fieldsNovita Agent Sandbox

No additional connection context.

2 create fieldsDaytona

No additional connection context.

2 create fieldsModal

1 typed connection field.

2 create fieldsRunloop

No additional connection context.

2 create fieldsSmol Machines

No additional connection context.

0 create fieldsFly.io Sprites

No additional connection context.

2 create fieldsVercel Sandbox

2 typed connection fields.

Stable error codes

Handle the stable code, not message text. Retry only the codes classified as retryable, and follow the operation-specific remediation.

invalid_requestDo not retry blindly

The request did not satisfy the endpoint contract.

Correct the fields identified by the response message before sending the request again.
payload_too_largeDo not retry blindly

The request body or file content exceeded the supported size limit.

Reduce the payload to the documented limit or split the work into smaller operations.
request_timeoutRetryable

Wildflower stopped waiting before the operation completed.

Retry with exponential backoff. For create operations, first reconcile using the operation ID because the provider may have succeeded.
invalid_idempotency_keyDo not retry blindly

The Idempotency-Key header was missing, malformed, or outside the supported length.

Send a stable, non-secret key that follows the documented Idempotency-Key constraints.
idempotency_conflictDo not retry blindly

The same idempotency key was reused with a different create request.

Reuse the key only for the identical logical request, or generate a new key for changed input.
idempotency_in_progressRetryable

An identical idempotent operation is still running.

Wait for the Retry-After interval and retry the same request with the same idempotency key.
idempotency_outcome_unknownDo not retry blindly

Wildflower cannot safely determine whether a prior create reached the provider.

Do not issue a blind create retry. Reconcile the operation ID with the sandbox registry or support.
idempotency_unavailableRetryable

The idempotency store was temporarily unavailable.

Retry with exponential backoff and the same idempotency key.
sandbox_registry_unavailableRetryable

The sandbox registry could not be read or updated.

Retry with exponential backoff. For create or delete, preserve identifiers and reconcile state before repeating the operation.
sandbox_create_outcome_unknownDo not retry blindly

The provider create outcome could not be confirmed.

Do not create again automatically. Use the operation ID to reconcile the provider and Wildflower registry.
invalid_file_contentDo not retry blindly

File content was not valid for the declared wire encoding.

Encode the content as valid UTF-8 or base64 and make the encoding field match.
file_not_utf8Do not retry blindly

The requested file contains bytes that cannot be returned as UTF-8.

Read the file with base64 encoding instead.
file_operation_failedDo not retry blindly

The provider could not complete the requested file operation.

Verify that the path exists, is permitted, and is within provider limits before retrying.
missing_api_keyDo not retry blindly

No usable Wildflower or provider credential was supplied.

Configure the required project API key and connect or supply the provider credential.
provider_profiles_unavailableRetryable

Connected provider profiles could not be loaded.

Retry with exponential backoff; do not replace a stored profile unless the failure persists.
provider_profile_not_foundDo not retry blindly

The project has no connected profile for the requested provider.

Connect that provider or supply a valid inline provider credential for the request.
provider_operation_unavailableDo not retry blindly

A prior deep verification proved that the connected provider credential cannot perform the requested operation.

Use the response operation, reason, and remediation fields to grant the missing permission, replace the credential, or choose a supported provider.
invalid_sandbox_idDo not retry blindly

The sandbox ID is malformed or names a provider that does not match the route.

Use the opaque sandbox ID returned by Wildflower without modifying it.
provider_invalid_requestDo not retry blindly

The selected provider rejected the normalized request as invalid.

Correct provider-specific image, timeout, command, or connection settings before retrying.
authentication_errorDo not retry blindly

A Wildflower or upstream provider credential was rejected.

Replace or reconnect the invalid credential, then retry the original operation.
control_plane_conflictDo not retry blindly

The requested account or project mutation conflicts with current control-plane state.

Refresh the current resource state and submit a mutation that satisfies its ownership and lifecycle rules.
last_account_ownerDo not retry blindly

The operation would leave an organization without an owner.

Promote another member to owner before removing, demoting, or transferring the current owner.
personal_account_immutableDo not retry blindly

The requested ownership or membership change is not allowed for a personal account.

Use an organization account for shared ownership and membership changes.
account_deletingDo not retry blindly

The account is already in its deletion lifecycle.

Wait for deletion to finish and avoid starting new work in the account.
sandbox_not_foundDo not retry blindly

No sandbox visible to this project matches the supplied ID.

Check the project and sandbox ID; a previously deleted sandbox cannot be restored through this endpoint.
rate_limitedRetryable

The request exceeded a Wildflower or provider rate limit.

Wait for Retry-After when present, then retry with exponential backoff and jitter.
provider_unavailableRetryable

The selected provider or customer-owned bridge is temporarily unavailable.

Retry with exponential backoff or select another provider when workload portability permits.
provider_errorDo not retry blindly

The provider returned a failure that Wildflower could not classify more narrowly.

Inspect the safe response message and operation ID; retry only when the provider condition is known to be transient.
internal_errorRetryable

Wildflower encountered an unexpected server-side failure.

Retry with exponential backoff and retain the request or operation ID for support if the failure repeats.
legal_acceptance_requiredDo not retry blindly

The actor or account must accept the current legal release before continuing.

Review and accept the required documents, then repeat the blocked operation.
legal_release_changedDo not retry blindly

The legal release changed between review and acceptance.

Fetch and review the new current release before submitting acceptance again.
legal_not_foundDo not retry blindly

The requested legal document or release does not exist.

Refresh the legal manifest and use a published document and version.
legal_unavailableRetryable

The legal publication or acceptance store is temporarily unavailable.

Retry with exponential backoff; do not assume acceptance was recorded unless it can be confirmed.
invalid_email_webhookDo not retry blindly

The inbound email webhook signature or payload was invalid.

Verify webhook signing configuration and send a payload that matches the documented provider event shape.