Create API Key

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Example name",
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "member_principal_id": "3c044ef28d3c60180490868efdce0ca8"
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "b62967384a5222f7709e7ee5220e565f",
    "key": "sk-f6e5d4c3...redacted...b2a1",
    "key_prefix": "f6e5d4c3",
    "name": "Example name",
    "key_suffix": "b2a1"
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Example name",
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "member_principal_id": "3c044ef28d3c60180490868efdce0ca8"
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "b62967384a5222f7709e7ee5220e565f",
    "key": "sk-f6e5d4c3...redacted...b2a1",
    "key_prefix": "f6e5d4c3",
    "name": "Example name",
    "key_suffix": "b2a1"
  }
}

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

Creates an API key and returns its full value once. Pass member_principal_id to issue the key for a VIRTUAL member (the key then acts as that member); human members cannot be targeted.

Permission required: service_account:create (all keys)

When you set member_principal_id: member:manage_virtual
Changes that give someone an admin role, or that reduce what an admin can reach, also require the team owner or an admin.

Headers

string

Optional. Retrying with the same value replays the first result instead of creating a second key.

Request Body

string

required

Display name for the key

array

Optional. Client IPs or CIDR ranges (e.g. 10.0.0.1, 192.168.0.0/16) this key may be used from. Omit or send [] for no restriction.

string

Optional. Fallback model-routing group, same rule as group.

integer

Expiry, Unix seconds. Omit or send 0 for a key that never expires.

string

Optional. Model-routing group. Must be a public group or the owner’s own group.

string

Optional. Issue the key for this VIRTUAL member (from POST /members); the key acts as that member. Human members cannot be targeted.

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/api-keys' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Example name",
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "member_principal_id": "3c044ef28d3c60180490868efdce0ca8"
  }'

Response

object

Show API Key Created object

string

Stable identifier of this API key

string

The full API key, including the sk- prefix. Save it now — read endpoints never return it.

string

First 8 characters of the key body

string

Display name

string

Last 4 characters of the key

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "b62967384a5222f7709e7ee5220e565f",
    "key": "sk-f6e5d4c3...redacted...b2a1",
    "key_prefix": "f6e5d4c3",
    "name": "Example name",
    "key_suffix": "b2a1"
  }
}

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
`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
`503`	Temporarily unavailable. Retry later

MemoryLake API

Memory Router API

Headers

Request Body

Response

Errors

​Headers

​Request Body

​Response

​Errors

Headers

Request Body

Response

Errors