Skip to content
WAMP Cloud

Overview

WAMP Cloud API 1.0.0

Section titled “WAMP Cloud API 1.0.0”

The engine-agnostic, server-to-server API for durable WAMP agent Sessions. App backends authenticate with an installation-scoped bearer — an API key an administrator creates, or a token minted from an Ed25519 assertion — then use caller-owned UUIDs for retry-safe Session, Turn, Publication and Merge commands. Ordered Session Events are the durable integration authority. Every answer on /v1 is JSON, including the ones no operation below describes: a path this API does not have is 404 unknown_endpoint, and a path that does not answer your method is 405 method_not_allowed with an Allow header naming the ones it does.

Cloud integration and lifecycle guide

Information

  • License: Proprietary
  • OpenAPI version: 3.1.0

Operations

Section titled “ Operations ”
GET
/v1/me
POST
/auth/app-installation-token
POST
/api/apps/installation-intents
POST
/api/apps/installation-intents/{intentId}/status
GET
/v1/openapi.json
GET
/v1/docs
GET
/v1/capabilities
PUT
/v1/runtime-release-probe
DELETE
/v1/runtime-release-probe/{releaseSha}
GET
/v1/repositories
GET
/v1/repository-grants
GET
/v1/repository-grants/{grantId}/replacement
GET
/v1/sessions
GET
/v1/sessions/{sessionId}
PUT
/v1/sessions/{sessionId}
DELETE
/v1/sessions/{sessionId}
PATCH
/v1/sessions/{sessionId}
GET
/v1/sessions/{sessionId}/execution
PUT
/v1/sessions/{sessionId}/workspace
GET
/v1/environments
GET
/v1/environments/{environmentId}
PUT
/v1/environments/{environmentId}
DELETE
/v1/environments/{environmentId}
GET
/v1/environments/{environmentId}/revisions
POST
/v1/environments/{environmentId}/restore
POST
/v1/environments/{environmentId}/unarchive
PUT
/v1/environments/{environmentId}/secrets/{name}
DELETE
/v1/environments/{environmentId}/secrets/{name}
PUT
/v1/environments/{environmentId}/archives/{sha256}
PUT
/v1/organization/default-environment
GET
/v1/sessions/{sessionId}/turns
PUT
/v1/sessions/{sessionId}/turns/{turnId}
GET
/v1/sessions/{sessionId}/runs/{runId}
POST
/v1/sessions/{sessionId}/runs/{runId}/cancel
POST
/v1/transcriptions
GET
/v1/sessions/{sessionId}/interactions
PUT
/v1/sessions/{sessionId}/interactions/{interactionId}/decision
GET
/v1/sessions/stream
GET
/v1/sessions/{sessionId}/events
GET
/v1/sessions/{sessionId}/events/stream
GET
/v1/sessions/{sessionId}/artifacts
GET
/v1/sessions/{sessionId}/artifacts/{artifactId}
GET
/v1/sessions/{sessionId}/artifacts/{artifactId}/content
GET
/v1/sessions/{sessionId}/repository/review
GET
/v1/sessions/{sessionId}/publications
GET
/v1/sessions/{sessionId}/publications/{publicationId}
PUT
/v1/sessions/{sessionId}/publications/{publicationId}
GET
/v1/sessions/{sessionId}/publications/{publicationId}/merges
GET
/v1/sessions/{sessionId}/publications/{publicationId}/merges/{mergeId}
PUT
/v1/sessions/{sessionId}/publications/{publicationId}/merges/{mergeId}

Authentication

Section titled “ Authentication ”

cloudInstallationBearer

Section titled “cloudInstallationBearer”

An audience-bound installation credential for wamp-cloud: either an opaque installation API key an organization administrator creates in WAMP Account, or a 600-second token from POST /auth/app-installation-token. Both are accepted here and carry the same capabilities.

Security scheme type: http

cloudNativeBearer

Section titled “cloudNativeBearer”

An RFC 9068 access token issued to the first-party native wamp-cloud OIDC public client. The token is accepted only when both aud and client_id equal wamp-cloud and the linked user, organization membership, App installation, client grant, and human capability grant remain live.

Security scheme type: http

Bearer format: JWT