Updating an Access Grant

Learn how to update the time window for an Access Grant

Early Access Preview. The Access Grants API is currently in Alpha. We're actively developing it and seeking early feedback at [email protected]. Expect breaking changes as we refine the design.

You can update the starting and ending times for an Access Grant.

Note that you cannot update the access methods, entrances, or spaces associated with an Access Grant. To change these access characteristics, delete the Access Grant and recreate it.

Python

Code:

seam.access_grants.update(
    access_grant_id="4ec65722-bf38-4b2f-b4c8-f488aa6ba3f1",
    starts_at="2025-06-19T18:01:32.000Z",
    ends_at="2025-06-22T13:24:50.000Z",
)

Output:

None

cURL (bash)

Code:

curl --include --request POST "https://connect.getseam.com/access_grants/update" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "access_grant_id": "4ec65722-bf38-4b2f-b4c8-f488aa6ba3f1",
  "starts_at": "2025-06-19T18:01:32.000Z",
  "ends_at": "2025-06-22T13:24:50.000Z"
}
EOF

Output:

{}

JavaScript

Code:

await seam.accessGrants.update({
  access_grant_id: "4ec65722-bf38-4b2f-b4c8-f488aa6ba3f1",
  starts_at: "2025-06-19T18:01:32.000Z",
  ends_at: "2025-06-22T13:24:50.000Z",
});

Output:

// void

Ruby

Code:

seam.access_grants.update(
  access_grant_id: "4ec65722-bf38-4b2f-b4c8-f488aa6ba3f1",
  starts_at: "2025-06-19T18:01:32.000Z",
  ends_at: "2025-06-22T13:24:50.000Z",
)

Output:

nil

PHP

Code:

$seam->access_grants->update(
    access_grant_id: "4ec65722-bf38-4b2f-b4c8-f488aa6ba3f1",
    starts_at: "2025-06-19T18:01:32.000Z",
    ends_at: "2025-06-22T13:24:50.000Z"
);

Output:

C#

Code:

// Coming Soon!

Output:

// Coming Soon!

---

Updating Cards

If you update an Access Grant that includes a card access method, the access_method.card_encoding_required event indicates that you must re-encode the card using the same access method. After you re-encode the card, Seam emits an access_method.reissued event.

You can also view the is_encoding_required, is_issued, and issued_at properties of the affected access method.

---

Updating Mobile Keys

If you update an Access Grant that includes a mobile key access method, Seam emits an access_method.reissued event.

You can also view the is_issued and issued_at properties of the affected access method.