Get an Access Group

• Request Parameters

• Response

Returns a specified access group.

JavaScript

Returns a specified access group.

Code

await seam.acs.accessGroups.get({
  acs_access_group_id: "09eb5265-6e3b-4e6d-bf96-736171c547ae",
});

Output

{
  "access_group_type": "salto_ks_access_group",
  "access_group_type_display_name": "Salto KS Access Group",
  "acs_access_group_id": "09eb5265-6e3b-4e6d-bf96-736171c547ae",
  "acs_system_id": "045baa77-6d06-40fe-a2cd-b82eef688f4a",
  "connected_account_id": "daba7bd0-edb6-4bb9-a70b-f9ae08a0e301",
  "created_at": "2025-06-15T16:54:17.946453Z",
  "display_name": "Main Group",
  "external_type": "salto_ks_access_group",
  "external_type_display_name": "Salto KS Access Group",
  "is_managed": true,
  "name": "My Access Group",
  "warnings": [],
  "workspace_id": "ac19352c-869a-4209-9ce7-44c740a8b5d0"
}

cURL

Returns a specified access group.

Code

curl --include --request POST "https://connect.getseam.com/acs/access_groups/get" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "acs_access_group_id": "09eb5265-6e3b-4e6d-bf96-736171c547ae"
}
EOF

Output

{
  "acs_access_group": {
    "access_group_type": "salto_ks_access_group",
    "access_group_type_display_name": "Salto KS Access Group",
    "acs_access_group_id": "09eb5265-6e3b-4e6d-bf96-736171c547ae",
    "acs_system_id": "045baa77-6d06-40fe-a2cd-b82eef688f4a",
    "connected_account_id": "daba7bd0-edb6-4bb9-a70b-f9ae08a0e301",
    "created_at": "2025-06-15T16:54:17.946453Z",
    "display_name": "Main Group",
    "external_type": "salto_ks_access_group",
    "external_type_display_name": "Salto KS Access Group",
    "is_managed": true,
    "name": "My Access Group",
    "warnings": [],
    "workspace_id": "ac19352c-869a-4209-9ce7-44c740a8b5d0"
  }
}

Python

Returns a specified access group.

Code

seam.acs.access_groups.get(acs_access_group_id="09eb5265-6e3b-4e6d-bf96-736171c547ae")

Output

AcsAccessGroup(
    access_group_type="salto_ks_access_group",
    access_group_type_display_name="Salto KS Access Group",
    acs_access_group_id="09eb5265-6e3b-4e6d-bf96-736171c547ae",
    acs_system_id="045baa77-6d06-40fe-a2cd-b82eef688f4a",
    connected_account_id="daba7bd0-edb6-4bb9-a70b-f9ae08a0e301",
    created_at="2025-06-15T16:54:17.946453Z",
    display_name="Main Group",
    external_type="salto_ks_access_group",
    external_type_display_name="Salto KS Access Group",
    is_managed=true,
    name="My Access Group",
    warnings=[],
    workspace_id="ac19352c-869a-4209-9ce7-44c740a8b5d0",
)

Ruby

Returns a specified access group.

Code

seam.acs.access_groups.get(acs_access_group_id: "09eb5265-6e3b-4e6d-bf96-736171c547ae")

Output

{
  "access_group_type" => "salto_ks_access_group",
  "access_group_type_display_name" => "Salto KS Access Group",
  "acs_access_group_id" => "09eb5265-6e3b-4e6d-bf96-736171c547ae",
  "acs_system_id" => "045baa77-6d06-40fe-a2cd-b82eef688f4a",
  "connected_account_id" => "daba7bd0-edb6-4bb9-a70b-f9ae08a0e301",
  "created_at" => "2025-06-15T16:54:17.946453Z",
  "display_name" => "Main Group",
  "external_type" => "salto_ks_access_group",
  "external_type_display_name" => "Salto KS Access Group",
  "is_managed" => true,
  "name" => "My Access Group",
  "warnings" => [],
  "workspace_id" => "ac19352c-869a-4209-9ce7-44c740a8b5d0",
}

PHP

Returns a specified access group.

Code

<?php
$seam->acs->access_groups->get(
    acs_access_group_id: "09eb5265-6e3b-4e6d-bf96-736171c547ae"
);

Output

<?php
[
    "access_group_type" => "salto_ks_access_group",
    "access_group_type_display_name" => "Salto KS Access Group",
    "acs_access_group_id" => "09eb5265-6e3b-4e6d-bf96-736171c547ae",
    "acs_system_id" => "045baa77-6d06-40fe-a2cd-b82eef688f4a",
    "connected_account_id" => "daba7bd0-edb6-4bb9-a70b-f9ae08a0e301",
    "created_at" => "2025-06-15T16:54:17.946453Z",
    "display_name" => "Main Group",
    "external_type" => "salto_ks_access_group",
    "external_type_display_name" => "Salto KS Access Group",
    "is_managed" => true,
    "name" => "My Access Group",
    "warnings" => [],
    "workspace_id" => "ac19352c-869a-4209-9ce7-44c740a8b5d0",
];

Seam CLI

Returns a specified access group.

Code

seam acs access-groups get --acs_access_group_id "09eb5265-6e3b-4e6d-bf96-736171c547ae"

Output

{
  "access_group_type": "salto_ks_access_group",
  "access_group_type_display_name": "Salto KS Access Group",
  "acs_access_group_id": "09eb5265-6e3b-4e6d-bf96-736171c547ae",
  "acs_system_id": "045baa77-6d06-40fe-a2cd-b82eef688f4a",
  "connected_account_id": "daba7bd0-edb6-4bb9-a70b-f9ae08a0e301",
  "created_at": "2025-06-15T16:54:17.946453Z",
  "display_name": "Main Group",
  "external_type": "salto_ks_access_group",
  "external_type_display_name": "Salto KS Access Group",
  "is_managed": true,
  "name": "My Access Group",
  "warnings": [],
  "workspace_id": "ac19352c-869a-4209-9ce7-44c740a8b5d0"
}

Authentication Methods

• API key

• Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

Request Parameters

acs_access_group_id String (Required)

ID of the access group that you want to get.

---

Response

acs_access_group

JSON

{
  "access_group_type": "salto_ks_access_group",
  "access_group_type_display_name": "Salto KS Access Group",
  "acs_access_group_id": "3f448826-9875-4947-9519-e468090a4f7d",
  "acs_system_id": "045baa77-6d06-40fe-a2cd-b82eef688f4a",
  "connected_account_id": "daba7bd0-edb6-4bb9-a70b-f9ae08a0e301",
  "created_at": "2025-06-15T16:54:17.946453Z",
  "display_name": "Main Group",
  "external_type": "salto_ks_access_group",
  "external_type_display_name": "Salto KS Access Group",
  "is_managed": true,
  "name": "My Access Group",
  "warnings": [],
  "workspace_id": "ac19352c-869a-4209-9ce7-44c740a8b5d0"
}