---
title: "Queries Gremlin's view of Autoscaling Groups in a given AWS account"
method: GET
path: "/aws/metadata/autoscaling-groups"
tags: ["aws.metadata"]
---

# Queries Gremlin's view of Autoscaling Groups in a given AWS account

`GET /aws/metadata/autoscaling-groups`

This endpoint returns Gremlin's view of Autoscaling Groups in a given AWS account.  The `domain` parameter refers to the AWS AccountId.  
NOTE: This endpoint may (or may not) return Autoscaling Groups which have already been assigned to Gremlin Services, or ones which we cannot assign to Gremlin Services
Requires the privilege [`MINIMUM_TEAM_PRIVILEGES`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Query parameters

- `domain` string, required
- `mode` 'Onboarding'
- `teamId` string, required

## Response `default`

default response

- AwsAutoscalingGroupsForAccount
  - `domain` string
  - `autoscalingGroups` AwsAutoscalingGroupResponse[]
    - `name` string
    - `arn` string
    - `region` string
    - `serviceIds` string[]
    - `discoveredAt` string, date-time

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: MINIMUM_TEAM_PRIVILEGES

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/36ee938323f0/schema)