---
title: "List Instant Keys"
method: POST
path: "/instant_keys/list"
---

# List Instant Keys

`POST /instant_keys/list`

Returns a list of all [instant keys](/capability-guides/instant-keys).

## Request body

- object
  - `user_identity_id` string, uuid — ID of the user identity by which you want to filter the list of Instant Keys.

## Response `200`

OK

- object
  - `instant_keys` InstantKey[], required
    - `client_session_id` string, uuid, required — ID of the client session associated with the Instant Key.
    - `created_at` string, date-time, required — Date and time at which the Instant Key was created.
    - `customization` object — Customization applied to the Instant Key UI.
      - `logo_url` string, uri — URL of the logo displayed on the Instant Key.
      - `primary_color` string — Primary color used in the Instant Key UI.
      - `secondary_color` string — Secondary color used in the Instant Key UI.
    - `customization_profile_id` string, uuid — ID of the customization profile associated with the Instant Key.
    - `expires_at` string, date-time, required — Date and time at which the Instant Key expires.
    - `instant_key_id` string, uuid, required — ID of the Instant Key.
    - `instant_key_url` string, uri, required — Shareable URL for the Instant Key. Use the URL to deliver the Instant Key to your user through a link in a text message or email or by embedding it in your web app.
    - `user_identity_id` string, uuid, required — ID of the user identity associated with the Instant Key.
    - `workspace_id` string, uuid, required — ID of the workspace that contains the Instant Key.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/versions/00c35395ce12/schema)