Get asset group by ID

Retrieve asset group by ID

GET /api/v2/asset-groups/{asset_group_id}

Get asset group by ID

cURL

curl --request GET \
  --url https://your-tenant.bloodhoundenterprise.io/api/v2/asset-groups/{asset_group_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "id": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": {
      "time": "2023-11-07T05:31:56Z",
      "valid": true
    },
    "name": "<string>",
    "tag": "<string>",
    "system_group": true,
    "selectors": [
      {
        "id": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "deleted_at": {
          "time": "2023-11-07T05:31:56Z",
          "valid": true
        },
        "asset_group_id": 123,
        "name": "<string>",
        "selector": "<string>",
        "system_selector": true
      }
    ],
    "member_count": 123
  }
}

Authorizations

JWTBearerTokenSignedRequest & RequestDate & HMACSignature

Authorization · string · header · required

Authorization: Bearer $JWT_TOKEN

Headers

Prefer · string · default: wait=30

Prefer header, used to specify a custom timeout in seconds using the wait parameter as per RFC7240. Passing in wait=-1 bypasses all timeout limits when the feature is enabled.

Pattern: ^wait=(-1|[0-9]+)$

Path Parameters

asset_group_id · integer<int32> · required

ID of the asset group record to retrieve

Response

200

application/json

OK

data · object

Show child attributes