# WAMP Cloud documentation > WAMP Cloud runs durable AI coding agents in managed sandboxes, driven over HTTP from any backend. Sessions outlive the request; runs are server-owned and retry-safe because the caller mints the identifiers. The desktop platform — extensions, apps, branded products, the plugin API — is documented separately at https://docs.vampikez.fun. This file indexes every page. For the entire corpus as one markdown document, fetch https://docs.cloud.vampikez.fun/llms-full.txt. Any single page is also served as its markdown source: append `.md` to its path, for example https://docs.cloud.vampikez.fun/concepts/artifacts.md. ## Concepts - [Agents](https://docs.cloud.vampikez.fun/concepts/agents/): Choose a runtime and model, select agent settings on each turn, and understand what survives a sandbox replacement. - [Artifacts](https://docs.cloud.vampikez.fun/concepts/artifacts/): How a run's outputs are recorded as content-addressed artifacts, how to fetch and verify their bytes, and which of them a run keeps at all. - [Organization environments](https://docs.cloud.vampikez.fun/concepts/environments/): Configure Cloud sandboxes with revisioned setup, variables, secrets, extensions and cache paths. - [Publications](https://docs.cloud.vampikez.fun/concepts/publications/): How an exact reviewed revision becomes a pull request or an explicitly authorized direct branch update, and how pull-request merges remain exact-head commands. - [Repositories](https://docs.cloud.vampikez.fun/concepts/repositories/): How a session gets source code — a public clone or a GitHub repository grant — and what the grant model guarantees about authority, pinning, and revocation. - [Sandboxes and environments](https://docs.cloud.vampikez.fun/concepts/sandboxes/): Compute in WAMP Cloud is not a resource you manage — it is a three-state projection on the session, and this page explains how to read it and what survives when it expires. - [Sessions, turns, runs](https://docs.cloud.vampikez.fun/concepts/sessions-turns-runs/): The three durable objects every WAMP Cloud integration is built from, the identifiers you mint for them, and the exact states they move through. ## Guides - [Connect a repository](https://docs.cloud.vampikez.fun/guides/connect-a-repository/): Attach an administrator-authorized private GitHub repository to a Cloud session, understand what the sandbox actually receives, and recover when the authorization behind a stored grant id changes. - [Follow a run live](https://docs.cloud.vampikez.fun/guides/follow-a-run/): Follow a Session's durable Event log over Server-Sent Events, handle a Run's outcome, resume from a saved cursor, and follow many Sessions on one connection. - [Drive Cloud from a backend](https://docs.cloud.vampikez.fun/guides/from-your-backend/): The integration shape for a CRM, bot, scheduler, or web app — where the signing key lives, when to mint tokens, how to map your users onto sessions, and what your database has to store. - [Open a pull request](https://docs.cloud.vampikez.fun/guides/open-a-pull-request/): Turn finished agent work into a reviewable draft pull request, then merge exactly the head that was reviewed, including when branch protection makes you wait. - [Push directly to a branch](https://docs.cloud.vampikez.fun/guides/push-directly-to-a-branch/): Land a session's reviewed work straight onto its base branch with delivery "direct_branch" — what authority it takes, what the server guarantees, and how a rejection arrives. ## Overview - [WAMP Cloud](https://docs.cloud.vampikez.fun/): Run durable hosted agent sessions in managed sandboxes, driven over HTTP from any backend — a web app, a CRM, a chat bot, or a scheduler. ## Reference - [API conventions](https://docs.cloud.vampikez.fun/reference/api/): The rules every WAMP Cloud endpoint shares — one bearer scheme, caller-owned ids with idempotent PUT, three pagination schemes, content negotiation, and how to read the generated operation reference. - [Errors](https://docs.cloud.vampikez.fun/reference/errors/): Every status and machine code the WAMP Cloud API returns, what causes it, and whether retrying helps — including the conflict semantics of idempotent PUT and what 410 Gone means. - [Events](https://docs.cloud.vampikez.fun/reference/events/): The complete catalog of the 23 WAMP Cloud session event types, their payloads, and when each one is appended. - [Limits](https://docs.cloud.vampikez.fun/reference/limits/): Every rate limit, quota, size cap, concurrency ceiling and timeout the WAMP Cloud API enforces — and which limits do not exist, so you do not design around a number nobody set. - [SDK](https://docs.cloud.vampikez.fun/reference/sdk/): What the WAMP Cloud TypeScript client exposes, the drift guard that keeps it honest, and why you may want to call the HTTP API directly instead. ## Start - [Authentication](https://docs.cloud.vampikez.fun/start/authentication/): Choose between the installation API key and the Ed25519 assertion flow, produce a credential /v1 accepts, refresh it before it expires, and learn which capability gates which call. - [Integrate WAMP Cloud](https://docs.cloud.vampikez.fun/start/integrate/): Authenticate a backend, submit a durable agent task, and read its outcome with a complete Shell or TypeScript example. - [What Cloud is](https://docs.cloud.vampikez.fun/start/what-cloud-is/): Run durable agent work from a backend through Sessions, Turns, Runs and an ordered event log. ## Api - [API reference — Artifacts](https://docs.cloud.vampikez.fun/api/operations/tags/artifacts/): Every operation and field in the Artifacts group, generated from the OpenAPI contract. - [API reference — Authentication](https://docs.cloud.vampikez.fun/api/operations/tags/authentication/): Every operation and field in the Authentication group, generated from the OpenAPI contract. - [API reference — Capabilities](https://docs.cloud.vampikez.fun/api/operations/tags/capabilities/): Every operation and field in the Capabilities group, generated from the OpenAPI contract. - [API reference — Environments](https://docs.cloud.vampikez.fun/api/operations/tags/environments/): Every operation and field in the Environments group, generated from the OpenAPI contract. - [API reference — Events](https://docs.cloud.vampikez.fun/api/operations/tags/events/): Every operation and field in the Events group, generated from the OpenAPI contract. - [API reference — Interactions](https://docs.cloud.vampikez.fun/api/operations/tags/interactions/): Every operation and field in the Interactions group, generated from the OpenAPI contract. - [API reference — Publications](https://docs.cloud.vampikez.fun/api/operations/tags/publications/): Every operation and field in the Publications group, generated from the OpenAPI contract. - [API reference — Repository grants](https://docs.cloud.vampikez.fun/api/operations/tags/repository-grants/): Every operation and field in the Repository grants group, generated from the OpenAPI contract. - [API reference — schemas](https://docs.cloud.vampikez.fun/api/): Every operation and field in the schemas group, generated from the OpenAPI contract. - [API reference — Sessions](https://docs.cloud.vampikez.fun/api/operations/tags/sessions/): Every operation and field in the Sessions group, generated from the OpenAPI contract. - [API reference — Transcriptions](https://docs.cloud.vampikez.fun/api/operations/tags/transcriptions/): Every operation and field in the Transcriptions group, generated from the OpenAPI contract. - [API reference — Turns and Runs](https://docs.cloud.vampikez.fun/api/operations/tags/turns-and-runs/): Every operation and field in the Turns and Runs group, generated from the OpenAPI contract.