Update API Key

curl -X PATCH 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys/9d971b8b5813eb1ecceec31354c101b4' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "name": "Example name",
    "status": "enabled"
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "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"
    }
  }
}

curl -X PATCH 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys/9d971b8b5813eb1ecceec31354c101b4' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "name": "Example name",
    "status": "enabled"
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "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"
    }
  }
}

PATCH /openapi/memorylake/admin/v1/api-keys/{id}

Changes an API key’s name, status, expiry, IP restriction or routing groups. Only the fields you send change; null is rejected — send [] or "" to clear. An expired key can be enabled only together with a future expires_at; a key whose owner has been deleted cannot be enabled; the key used for this request cannot disable itself. Routing groups must be public or the key owner’s own.

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

Path Parameters

string

required

Identifier of the API key

Request Body

array

Replace the IP / CIDR restriction. [] removes it.

string

Fallback model-routing group. "" clears it.

integer

New expiry, Unix seconds. 0 = never expires.

string

Model-routing group. "" clears it.

string

New display name. Usage records are kept under the key’s name at the time of each request, so renaming splits the key’s history.

string

Enable or disable the key. An expired key can be enabled only together with a future expires_at. One of: enabled, disabled.

curl -X PATCH 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys/9d971b8b5813eb1ecceec31354c101b4' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "name": "Example name",
    "status": "enabled"
  }'

Response

object

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)

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "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"
    }
  }
}

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
`404`	The resource does not exist
`409`	The request conflicts with the current state, e.g. a duplicate or a limit reached
`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

Path Parameters

Request Body

Response

Errors

​Path Parameters

​Request Body

​Response

​Errors

Path Parameters

Request Body

Response

Errors