Create Virtual Member

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/members' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "display_name": "Alice",
    "role": "tenant_member"
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "display_name": "Alice",
    "joined_at": 1760000000,
    "member_type": "human",
    "principal_id": "42fbbd89934900ebbc74814c49f009d2",
    "role": "tenant_member",
    "status": "active",
    "used_tokens": 1200000,
    "email": "alice@example.com",
    "max_tokens": 1200000,
    "username": "alice"
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/members' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "display_name": "Alice",
    "role": "tenant_member"
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "display_name": "Alice",
    "joined_at": 1760000000,
    "member_type": "human",
    "principal_id": "42fbbd89934900ebbc74814c49f009d2",
    "role": "tenant_member",
    "status": "active",
    "used_tokens": 1200000,
    "email": "alice@example.com",
    "max_tokens": 1200000,
    "username": "alice"
  }
}

POST /openapi/memorylake/admin/v1/members

Creates a VIRTUAL member — a login-less managed identity that appears in the roster, holds a role, and acts only through API keys issued for it (POST /api-keys with member_principal_id). Human members join through invitations only.

Permission required: 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.

Request Body

string

required

Display name of the virtual member

string

required

Role: tenant_admin, tenant_member, or a custom role key of this team. The owner role cannot be assigned.

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/members' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "display_name": "Alice",
    "role": "tenant_member"
  }'

Response

object

Show Member object

string

Member’s display name

integer

Time this member joined, Unix seconds

string

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

string

Stable identifier of this member

string

Primary role in this team: tenant_owner | tenant_admin | tenant_member | <custom role>

string

Membership state. One of: active, inactive.

integer

Tokens consumed by this member

string

Only returned to team owners and admins

integer

Per-member cap in tokens. Omitted when the member is uncapped.

string

Only returned to team owners and admins

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "display_name": "Alice",
    "joined_at": 1760000000,
    "member_type": "human",
    "principal_id": "42fbbd89934900ebbc74814c49f009d2",
    "role": "tenant_member",
    "status": "active",
    "used_tokens": 1200000,
    "email": "alice@example.com",
    "max_tokens": 1200000,
    "username": "alice"
  }
}

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