---
title: "Zig sandbox SDK."
description: "Generated synchronous Zig sandbox SDK with explicit allocation, a narrow transport boundary, and owned return values. Review authentication, compatibility, and package provenance."
canonical: "https://wildflower.computer/sdk/zig/"
openapi_version: "0.8.0"
source_revision: "788b7325a454b8b753a7d614247d5694bad5c967"
---

# Zig sandbox SDK.

Generated synchronous Zig sandbox SDK with explicit allocation, a narrow transport boundary, and owned return values. The generated client is version 0.8.0 and calls the Wildflower Computer API v1 contract.

## Create, execute, and delete

This example uses E2B to make the provider input concrete. The generated client also includes typed creation inputs for the other providers in the 12-adapter OpenAPI contract.

```zig
var client = try Wildflower.init(
    allocator,
    wildflower_api_key,
    transport,
);
defer client.deinit();

var sandbox = try client.create(.{ .e2b = .{
    .api_key = null,
    .image = "base",
    .timeout = 300,
} });
defer sandbox.deinit();

var handle = client.attach(sandbox.value.id);
var result = try handle.runCommand(.{ .command = "echo hello" });
defer result.deinit();
var written = try handle.writeText("/tmp/hello.txt", "hello");
defer written.deinit();
var deleted = try handle.delete();
defer deleted.deinit();
```

## Authentication model

The Wildflower Computer API key authenticates the application. The selected provider credential is resolved from a connected project profile or sent as an inline override. Inline secrets are carried in headers and never serialized into the JSON request body.

A fresh process can use the same connected project profile. Inline mode requires the credential again; provider-specific connection context remains typed separately.

## Error model

API failures expose stable error codes, HTTP status, an optional provider, and the response `X-Request-Id`. A command with a non-zero exit code is a successful execution result, not an API failure.

## Generated package provenance

| Package version | `0.8.0` |
| --- | --- |
| API version | `v1` |
| OpenAPI version | `0.8.0` |
| Generator version | `0.7.0` |
| OpenAPI SHA-256 | `7e4f085adbee5ae5e63941b3286eebbbc90d2185735f5ac2b0a1093432e81c4f` |
| Source revision | `788b7325a454b8b753a7d614247d5694bad5c967` |

## Availability

Distribution status: **source-only**. The generated package exists in the API source repository and its local release-candidate pipeline. This page does not claim registry publication while the generated status remains source-only.

## Continue

- [Shared lifecycle quickstart](https://wildflower.computer/docs/getting-started/)
- [Authentication and normalized error concepts](https://wildflower.computer/docs/concepts/)
- [Provider compatibility matrix](https://wildflower.computer/compatibility/)
- [OpenAPI and JSON schema downloads](https://wildflower.computer/openapi/)

> **wildflower** — Generated package Zig 0.16.0 · Synchronous transport boundary