What’s New

Beyond Identity is announcing the release of the following APIs:

• Retrieve groups for a user
• Passkeys
  • List passkeys
  • Delete a passkey
  • Get tags associated with a passkey
  • Replace the tags associated with a new list of passkeys

Retrieve groups for a user

Returns a list of all groups to which a user belongs. Documentation for this feature is located under the Users section of the API documentation.

To list groups associated with a specific user, send a GET request to /v2/users/$USER_ID/groups. You can also set parameters for the number of items returned per page (page_size) and the number of items to skip (offset).

Passkeys

A new Passkeys section has been added to the API documentation with the following features:

List passkeys

Returns a list of all passkeys for a given tenant and realm. To return a list of passkeys, send a GET request to /v2/passkeys. You can also set parameters for:

• Filter supported fields, such as whether the device is jailbroken

• Apply a fuzzy search using a "search" field, which looks at username and hostname: search (eq)

• Sort a number of fields in ascending/descending order (order_by)

• Number of items returned per page (page_size)

• Number of items to skip (offset)

Delete a passkey

Deletes a passkey from the current tenant and realm. To delete a passkey, send a DELETE request to /v2/passkeys/$PASSKEY_ID.

Get tags associated with a passkey

Returns the id and name tags associated with a specific passkey. To get tags for a passkey, send a GET request to /v2/passkeys/$PASSKEY_ID/tags.

Replace the tags associated with a new list of passkeys

Replaces the id and name values of current tags associated with a specific passkey with new tag values. This list will replace all existing tags associated with a passkey. For example, if a provided tag does not include an id, a new tag value will be created if you change the name tag.

To replace a passkey’s tag values, send a PUT request to /v2/passkeys/$PASSKEY_ID/tags.