Convert an Unmanaged Access Code

• Request Parameters

• Response

Converts an unmanaged access code to an access code managed through Seam.

An unmanaged access code has a limited set of operations that you can perform on it. Once you convert an unmanaged access code to a managed access code, the full set of access code operations and lifecycle events becomes available for it.

Note that not all device providers support converting an unmanaged access code to a managed access code.

JavaScript

Converts an unmanaged access code to an access code managed through Seam.

Code:

await seam.accessCodes.unmanaged.convertToManaged({
  access_code_id: "9ef2af02-e335-4b49-bd51-00e851a83ef6",
  is_external_modification_allowed: true,
  force: true,
});

Output:

// void

cURL

Converts an unmanaged access code to an access code managed through Seam.

Code:

curl --include --request POST "https://connect.getseam.com/access_codes/unmanaged/convert_to_managed" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "access_code_id": "9ef2af02-e335-4b49-bd51-00e851a83ef6",
  "is_external_modification_allowed": true,
  "force": true
}
EOF

Output:

{}

Python

Converts an unmanaged access code to an access code managed through Seam.

Code:

seam.access_codes.unmanaged.convert_to_managed(
    access_code_id="9ef2af02-e335-4b49-bd51-00e851a83ef6",
    is_external_modification_allowed=true,
    force=true,
)

Output:

None

Ruby

Converts an unmanaged access code to an access code managed through Seam.

Code:

seam.access_codes.unmanaged.convert_to_managed(
  access_code_id: "9ef2af02-e335-4b49-bd51-00e851a83ef6",
  is_external_modification_allowed: true,
  force: true,
)

Output:

nil

PHP

Converts an unmanaged access code to an access code managed through Seam.

Code:

$seam->access_codes->unmanaged->convert_to_managed(
    access_code_id: "9ef2af02-e335-4b49-bd51-00e851a83ef6",
    is_external_modification_allowed: true,
    force: true
);

Output:

Seam CLI

Converts an unmanaged access code to an access code managed through Seam.

Code:

seam access-codes unmanaged convert-to-managed --access_code_id "9ef2af02-e335-4b49-bd51-00e851a83ef6" --is_external_modification_allowed true --force true

Output:

{}

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

access_code_id String (Required)

ID of the unmanaged access code that you want to convert to a managed access code.

---

allow_external_modification Boolean

Indicates whether external modification of the access code is allowed.

---

force Boolean

Indicates whether to force the access code conversion. To switch management of an access code from one Seam workspace to another, set force to true.

---

is_external_modification_allowed Boolean

Indicates whether external modification of the access code is allowed.

---

Response

void