Access Methods
Early Access Preview. The access methods 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.
The access_method Object
Represents an access method for an Access Grant. Access methods describe the modes of access, such as PIN codes, plastic cards, and mobile keys. For a mobile key, the access method also stores the URL for the associated Instant Key.
A card access method resource.
{
"access_method_id": "27d8ad77-55c2-4e20-b5b3-43555926f0e8",
"created_at": "2025-06-14T16:54:17.946612Z",
"display_name": "My Card",
"is_card_encoding_required": true,
"issued_at": "2025-06-14T16:54:17.946612Z",
"mode": "card",
"workspace_id": "661025d3-c1d2-403c-83a8-af153aaedfbc"
}A mobile key access method resource.
{
"access_method_id": "27d8ad77-55c2-4e20-b5b3-43555926f0e8",
"created_at": "2025-06-14T16:54:17.946612Z",
"display_name": "My Mobile Key",
"instant_key_url": "https://ik.seam.co/ABCXYZ",
"is_card_encoding_required": false,
"mode": "mobile_key",
"workspace_id": "661025d3-c1d2-403c-83a8-af153aaedfbc"
}A PIN code access method resource.
Properties
access_method_id UUID
ID of the access method.
client_session_token String
Token of the client session associated with the access method.
code String
The actual PIN code for code access methods.
created_at Datetime
Date and time at which the access method was created.
customization_profile_id UUID
ID of the customization profile associated with the access method.
display_name String
Display name of the access method.
instant_key_url String
URL of the Instant Key for mobile key access methods.
is_encoding_required Boolean
Indicates whether encoding with an card encoder is required to issue or reissue the plastic card associated with the access method.
is_issued Boolean
Indicates whether the access method has been issued.
issued_at Datetime
Date and time at which the access method was issued.
mode Enum
Access method mode. Supported values: code, card, mobile_key.
warnings List of Objects
Warnings associated with the access method.
The specific structure of each object in this list depends on the value of its warning_code field.
Variants:
being_deleted
Indicates that the access method is being deleted.
created_at Datetime
Date and time at which Seam created the warning.
message String
Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.
warning_code Enum
Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.
Enum values:
being_deleted
workspace_id UUID
ID of the Seam workspace associated with the access method.
Warnings
being_deleted
Indicates that the access method is being deleted.
Events
access_method.issued
An access method was issued.
Properties
access_grant_ids List of UUIDs
IDs of the access grants associated with this access method.
access_grant_keys List of Strings
Keys of the access grants associated with this access method (if present).
access_method_id UUID
ID of the affected access method.
code String
The actual PIN code for code access methods (only present when mode is 'code').
created_at Datetime
Date and time at which the event was created.
event_id UUID
ID of the event.
event_type Enum
Value: access_method.issued
is_backup_code Boolean
Indicates whether the code is a backup code (only present when mode is 'code' and a backup code was used).
occurred_at Datetime
Date and time at which the event occurred.
workspace_id UUID
ID of the workspace associated with the event.
access_method.revoked
An access method was revoked.
Properties
access_grant_ids List of UUIDs
IDs of the access grants associated with this access method.
access_grant_keys List of Strings
Keys of the access grants associated with this access method (if present).
access_method_id UUID
ID of the affected access method.
created_at Datetime
Date and time at which the event was created.
event_id UUID
ID of the event.
event_type Enum
Value: access_method.revoked
occurred_at Datetime
Date and time at which the event occurred.
workspace_id UUID
ID of the workspace associated with the event.
access_method.card_encoding_required
An access method representing a physical card requires encoding.
Properties
access_grant_ids List of UUIDs
IDs of the access grants associated with this access method.
access_grant_keys List of Strings
Keys of the access grants associated with this access method (if present).
access_method_id UUID
ID of the affected access method.
created_at Datetime
Date and time at which the event was created.
event_id UUID
ID of the event.
event_type Enum
Value: access_method.card_encoding_required
occurred_at Datetime
Date and time at which the event occurred.
workspace_id UUID
ID of the workspace associated with the event.
access_method.deleted
An access method was deleted.
Properties
access_grant_ids List of UUIDs
IDs of the access grants associated with this access method.
access_grant_keys List of Strings
Keys of the access grants associated with this access method (if present).
access_method_id UUID
ID of the affected access method.
created_at Datetime
Date and time at which the event was created.
event_id UUID
ID of the event.
event_type Enum
Value: access_method.deleted
occurred_at Datetime
Date and time at which the event occurred.
workspace_id UUID
ID of the workspace associated with the event.
access_method.reissued
An access method was reissued.
Properties
access_grant_ids List of UUIDs
IDs of the access grants associated with this access method.
access_grant_keys List of Strings
Keys of the access grants associated with this access method (if present).
access_method_id UUID
ID of the affected access method.
code String
The actual PIN code for code access methods (only present when mode is 'code').
created_at Datetime
Date and time at which the event was created.
event_id UUID
ID of the event.
event_type Enum
Value: access_method.reissued
is_backup_code Boolean
Indicates whether the code is a backup code (only present when mode is 'code' and a backup code was used).
occurred_at Datetime
Date and time at which the event occurred.
workspace_id UUID
ID of the workspace associated with the event.
Endpoints
Deletes an access method.
Encodes an existing access method onto a plastic card placed on the specified encoder.
Gets an access method.
Gets all related resources for one or more Access Methods.
Lists all access methods, usually filtered by Access Grant.
Last updated
Was this helpful?