List ACS Systems

• Request Parameters

• Response

• Examples

Returns a list of all access systems.

To filter the list of returned access systems by a specific connected account ID, include the connected_account_id in the request body. If you omit the connected_account_id parameter, the response includes all access systems connected to your workspace.

Signature

POST /acs/systems/list ⇒ { acs_systems: [acs_system, …] }

Authentication Methods

• API key

• Client session token

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

To learn more, see Authentication.

Request Parameters

connected_account_id String

ID of the connected account by which you want to filter the list of access systems.

---

Response

Array of acs_systems

JSON

{
  JSON representation of acs_system
}

---

Examples

List ACS systems by connected account

To filter the list of ACS systems, include a connected_account_id.

JavaScript

Code

await seam.acs.systems.list({
  connected_account_id: "123e4567-e89b-12d3-a456-426614174000",
});

Output

[{ "acs_system_id": "8d7e0b3a-b889-49a7-9164-4b71a0506a33" }]

Python

Code

seam.acs.systems.list(connected_account_id="123e4567-e89b-12d3-a456-426614174000")

Output

[AcsSystem(acs_system_id="8d7e0b3a-b889-49a7-9164-4b71a0506a33")]

Ruby

Code

seam.acs.systems.list(connected_account_id: "123e4567-e89b-12d3-a456-426614174000")

Output

[{ "acs_system_id" => "8d7e0b3a-b889-49a7-9164-4b71a0506a33" }]

PHP

Code

<?php
$seam->acs->systems->list(
    connected_account_id: "123e4567-e89b-12d3-a456-426614174000"
);

Output

<?php
[["acs_system_id" => "8d7e0b3a-b889-49a7-9164-4b71a0506a33"]];

Seam CLI

Code

seam acs systems list --connected_account_id "123e4567-e89b-12d3-a456-426614174000"

Output

[{ "acs_system_id": "8d7e0b3a-b889-49a7-9164-4b71a0506a33" }]

Go

Code

package main

import api "github.com/seamapi/go"
import systems "github.com/seamapi/go/systems"

func main() {
	client.Acs.Systems.List(
		context.Background(),
		systems.SystemsListRequest{
			ConnectedAccountId: api.String("123e4567-e89b-12d3-a456-426614174000"),
		},
	)
}

Output

[]api.AcsSystem{api.AcsSystem{AcsSystemId: "8d7e0b3a-b889-49a7-9164-4b71a0506a33"}}

cURL

Code

curl --include --request POST "https://connect.getseam.com/acs/systems/list" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "connected_account_id": "123e4567-e89b-12d3-a456-426614174000"
}
EOF

Output

{ "acs_systems": [{ "acs_system_id": "8d7e0b3a-b889-49a7-9164-4b71a0506a33" }] }