Bind Actor to Workspace - MemoryLake AI

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-7k8m9n0p1q2r/actors' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "actor_id": "act-a1b2c3d4e5f6"
  }'

{
  "success": true,
  "data": {
    "actor_id": "act-a1b2c3d4e5f6",
    "custom_id": "user-ext-001",
    "actor_type": "HUMAN",
    "display_name": "Alice Chen",
    "bound_at": "2025-03-15T09:00:00Z"
  }
}

POST /openapi/memorylake/api/v3/workspaces/{workspaceId}/actors

Binds an existing actor to a workspace. Once bound, the actor can participate in conversations within the workspace’s projects. An actor can be bound to multiple workspaces.

Permission required: workspace:actor_bind

Path Parameters

workspaceId

string

required

Workspace ID

Request Body

actor_id

string

required

ID of the actor to bind. The actor must already exist (see Create Actor).

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-7k8m9n0p1q2r/actors' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "actor_id": "act-a1b2c3d4e5f6"
  }'

Response

data

object

Show Actor binding

actor_id

string

Actor ID

custom_id

string

Caller-defined external identifier

actor_type

string

Actor type: HUMAN or ASSISTANT

display_name

string

Human-readable display name

bound_at

string

Timestamp when the actor was bound to this workspace

{
  "success": true,
  "data": {
    "actor_id": "act-a1b2c3d4e5f6",
    "custom_id": "user-ext-001",
    "actor_type": "HUMAN",
    "display_name": "Alice Chen",
    "bound_at": "2025-03-15T09:00:00Z"
  }
}

List Workspace Actors Unbind Actor from Workspace

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response