List Workspace Actors

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-7k8m9n0p1q2r/actors?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-7k8m9n0p1q2r/actors?page_size=20&continuation_token=eyJsYXN0X2lkIjoiYWN0LWY2ZTVkNCJ9' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "items": [
      {
        "actor_id": "act-a1b2c3d4e5f6",
        "custom_id": "user-ext-001",
        "actor_type": "HUMAN",
        "display_name": "Alice Chen",
        "tags": ["vip", "cn"],
        "bound_at": "2025-03-15T09:00:00Z"
      },
      {
        "actor_id": "act-f6e5d4c3b2a1",
        "custom_id": "system-intake",
        "actor_type": "ASSISTANT",
        "display_name": "Intake Bot",
        "tags": [],
        "bound_at": "2025-03-15T09:05:00Z"
      }
    ],
    "continuation_token": null
  }
}

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

Returns a paginated list of actors that are bound to the specified workspace. Only bound actors can participate in conversations within the workspace’s projects.

Permission required: workspace:actor_list

Path Parameters

string

required

Workspace ID

Query Parameters

integer

default:"20"

Number of bindings per page.

string

Token returned by the previous call. Omit on the first request.

string

Filter by actor type. One of HUMAN or ASSISTANT.

string

Fuzzy search by display name.

string[]

Filter by tag. Repeat the parameter (?tags=vip&tags=cn) or comma-separate the values (?tags=vip,cn) to require several tags at once — only actors carrying every listed tag are returned. Matching is exact and case-sensitive.

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-7k8m9n0p1q2r/actors?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws-7k8m9n0p1q2r/actors?page_size=20&continuation_token=eyJsYXN0X2lkIjoiYWN0LWY2ZTVkNCJ9' \
  -H 'Authorization: Bearer sk_xxxxxx'

Response

object

Show Paginated workspace actor bindings

array

Array of actor binding objects

Show Actor binding

string

Actor ID

string

Caller-defined external identifier

string

Actor type: HUMAN or ASSISTANT

string

Human-readable display name

string[]

Labels attached to the actor. Empty when the actor has none

string

Timestamp when the actor was bound to this workspace

string

Token for the next page. Absent or null when this is the last page.

{
  "success": true,
  "data": {
    "items": [
      {
        "actor_id": "act-a1b2c3d4e5f6",
        "custom_id": "user-ext-001",
        "actor_type": "HUMAN",
        "display_name": "Alice Chen",
        "tags": ["vip", "cn"],
        "bound_at": "2025-03-15T09:00:00Z"
      },
      {
        "actor_id": "act-f6e5d4c3b2a1",
        "custom_id": "system-intake",
        "actor_type": "ASSISTANT",
        "display_name": "Intake Bot",
        "tags": [],
        "bound_at": "2025-03-15T09:05:00Z"
      }
    ],
    "continuation_token": null
  }
}

MemoryLake API

Management API

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response