Skip to main content
GET
/
api
/
v2
/
environments
/
{id}
Retrieve an environment
curl --request GET \
  --url https://agp.eu.hcompany.ai/api/v2/environments/{id} \
  --header 'Authorization: Bearer <token>'
Retrieves the complete Environment object. Returns the Environment object if the identifier is valid and you have access.

Path parameters

id
string
required
The environment’s id (e.g., h/browser or my-browser). Slash-containing identifiers are supported.

Examples

curl "https://agp.eu.hcompany.ai/api/v2/environments/h/browser" \
  -H "Authorization: Bearer $H_API_KEY"
Response
{
  "id": "h/browser",
  "kind": "web",
  "headless": false,
  "width": 1200,
  "height": 1200,
  "start_url": "https://www.bing.com",
  "mode": "visual"
}

Errors

StatusCause
404Environment not found or you don’t have access.