Skip to main content
GET
Resolve live environment by id (external)

Authorizations

X-Asteroid-Agents-Api-Key
string
header
required

Path Parameters

environmentId
string<uuid>
required

The environment whose connection details to resolve.

Query Parameters

expectedAgentId
string<uuid>

Optional assertion that the env belongs to this agent; resolution fails (404) on mismatch. Omit it โ€” access is already gated on the env's own agent and organisation.

Response

The request has succeeded.

Connection details for a running environment, returned by the env-id attach endpoint. All fields are optional: an env that's still bootstrapping (no CDP URL yet) returns an empty response so the caller can proceed without browser tools.

cdpUrl
string

Chrome DevTools Protocol websocket URL. Present only for browser environments with a ready CDP endpoint.

credentials
object

Decrypted credential placeholders for the env's stamped agent profile, keyed by ##NAME## placeholder. Present only when the env has an attached profile with credentials. Internal-only.

cua
object

Provider-specific CUA connection details. Present for Anchor browsers and Daytona OS environments.