List API Keys

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "items": [
      {
        "allowed_ips": [
          "example"
        ],
        "created_at": 1760000000,
        "id": "40c8c8eba1dca6d1ba4bd63384a16d3c",
        "is_system": true,
        "key_prefix": "f6e5d4c3",
        "name": "Example name",
        "status": "enabled",
        "backup_group": "example",
        "expires_at": 1760000000,
        "group": "example",
        "key_suffix": "b2a1",
        "last_used_at": 1760000000,
        "owner": {
          "display_name": "Alice",
          "member_type": "human",
          "principal_id": "61083f9552ae2ae6bd9105e4e2763c7b"
        }
      }
    ],
    "continuation_token": "eyJvZmZzZXQiOjIwfQ",
    "total": 1
  }
}

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "items": [
      {
        "allowed_ips": [
          "example"
        ],
        "created_at": 1760000000,
        "id": "40c8c8eba1dca6d1ba4bd63384a16d3c",
        "is_system": true,
        "key_prefix": "f6e5d4c3",
        "name": "Example name",
        "status": "enabled",
        "backup_group": "example",
        "expires_at": 1760000000,
        "group": "example",
        "key_suffix": "b2a1",
        "last_used_at": 1760000000,
        "owner": {
          "display_name": "Alice",
          "member_type": "human",
          "principal_id": "61083f9552ae2ae6bd9105e4e2763c7b"
        }
      }
    ],
    "continuation_token": "eyJvZmZzZXQiOjIwfQ",
    "total": 1
  }
}

GET /openapi/memorylake/admin/v1/api-keys

Lists the API keys of your team. Callers holding only own-scope read permission see just the keys they created.

Permission required: service_account:read (all keys) or service_account:read (your own keys only)

When owner_principal_id names another member: service_account:read (all keys)

Query Parameters

integer

default:"20"

Number of items per page (1–100)

string

Token from the previous page. Opaque — do not construct or parse it.

string

Case-insensitive substring match on the key name

string

Only keys in this state (the status field). One of: enabled, disabled, expired.

string

Only keys owned by this member (owner.principal_id). With permission to read only your own keys, any principal_id other than yours is refused (403).

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys' \
  -H 'Authorization: Bearer sk_xxxxxx'

Response

object

Show Load More Response API Key object

array

List of items in the current page

Show API Key object

array

Client IPs or CIDR ranges this key may be used from. Empty array = no restriction.

integer

Creation time, Unix seconds

string

Stable identifier of this API key

boolean

true for keys the platform created for its own use (for example the console playground)

string

First 8 characters of the key body. The full key is never returned by read endpoints.

string

Display name

string

Current state of the key. One of: enabled, disabled, expired.

string

Fallback model-routing group. Omitted = none.

integer

Expiry time, Unix seconds. Omitted when the key never expires.

string

Model-routing group the key’s requests use. Omitted = the owner’s own group.

string

Last 4 characters of the key, to match a key someone holds without returning it. Omitted for keys whose plaintext is not retained.

integer

Time this key was last used, Unix seconds. APPROXIMATE — updates are throttled and may lag by up to one hour. Omitted when the key has never been used.

object

Member this key acts as — its requests carry this member’s permissions and usage is attributed to them. For a key issued to a virtual member, that member. Omitted when the account no longer exists.

Show API Key Owner object

string

Display name of the member

string

human = joined via invitation, virtual = managed identity created by an owner/admin

string

principal_id of the member (see GET /members)

string

Token to fetch the next page; absent on the last page

integer

Total number of items matching the filter across all pages; omitted when the count is unavailable

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "items": [
      {
        "allowed_ips": [
          "example"
        ],
        "created_at": 1760000000,
        "id": "40c8c8eba1dca6d1ba4bd63384a16d3c",
        "is_system": true,
        "key_prefix": "f6e5d4c3",
        "name": "Example name",
        "status": "enabled",
        "backup_group": "example",
        "expires_at": 1760000000,
        "group": "example",
        "key_suffix": "b2a1",
        "last_used_at": 1760000000,
        "owner": {
          "display_name": "Alice",
          "member_type": "human",
          "principal_id": "61083f9552ae2ae6bd9105e4e2763c7b"
        }
      }
    ],
    "continuation_token": "eyJvZmZzZXQiOjIwfQ",
    "total": 1
  }
}

Errors

Errors answer with success: false, a message and an error_code. See Error Codes for every code.

Status	Meaning
`400`	A parameter or the body is invalid
`401`	The API key is missing, invalid, disabled or expired
`403`	The key is not allowed to do this
`422`	The body or a parameter failed validation
`429`	Too many requests. Wait for the time in `Retry-After`
`500`	Server-side error

MemoryLake API

Memory Router API

Query Parameters

Response

Errors

​Query Parameters

​Response

​Errors

Query Parameters

Response

Errors