Skip to main content
GET
/
api
/
v2
/
environments
List environments
curl --request GET \
  --url https://agp.eu.hcompany.ai/api/v2/environments \
  --header 'Authorization: Bearer <token>'
Returns a paginated list of environments visible to you: both your custom environments and the built-in H preset catalog. Returns a paginated list of Environment objects.

​
Query parameters

​
page
integer
default:"1"
Page number (1-based).
​
size
integer
default:"10"
Items per page. Maximum: 1000.
​
sort
string
default:"-created_at"
Sort order. Options: created_at, -created_at, id, -id.

​
Examples

curl "https://agp.eu.hcompany.ai/api/v2/environments" \
  -H "Authorization: Bearer $H_API_KEY"
Each item is a full Environment object.
Response
{
  "items": [
    {"id": "h/browser", "kind": "web", "headless": false, "width": 1200, "height": 1200, "start_url": "https://www.bing.com", "mode": "visual"},
    {"id": "h/textual_browser", "kind": "web", "headless": false, "width": 1200, "height": 1200, "start_url": "https://www.bing.com", "mode": "text"}
  ],
  "page": 1,
  "total": 2
}