List Actors - MemoryLake AI

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

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/actors?actor_type=HUMAN' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/actors?display_name_fuzzy=Alice' \
  -H 'Authorization: Bearer sk_xxxxxx'

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

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "act-a1b2c3d4e5f6",
        "custom_id": "user-ext-001",
        "actor_type": "HUMAN",
        "display_name": "Alice Chen",
        "description": "Primary end user for the mobile app",
        "metadata": {
          "tier": "premium",
          "region": "us-west"
        },
        "created_at": "2025-03-10T08:00:00Z",
        "updated_at": "2025-03-10T08:00:00Z"
      },
      {
        "id": "act-f6e5d4c3b2a1",
        "custom_id": "system-intake",
        "actor_type": "ASSISTANT",
        "display_name": "Intake Bot",
        "description": "Automated intake system for onboarding flows",
        "metadata": {},
        "created_at": "2025-03-12T14:30:00Z",
        "updated_at": "2025-03-12T14:30:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiYWN0LWY2ZTVkNGMzYjJhMSJ9"
  }
}

GET /openapi/memorylake/api/v3/actors

Returns a paginated list of all actors in your account. You can filter by actor type or search by display name.

Permission required: actor:list

Query Parameters

integer

default:"20"

Number of actors 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.

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

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/actors?actor_type=HUMAN' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/actors?display_name_fuzzy=Alice' \
  -H 'Authorization: Bearer sk_xxxxxx'

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

Response

object

Show Paginated actor list

array

Array of actor objects

Show Actor object

string

Actor ID

string

Caller-defined external identifier

string

Actor type: HUMAN or ASSISTANT

string

Human-readable display name

string

Actor description

object

Caller-defined metadata (key-value pairs)

string

Creation timestamp

string

Last update timestamp

string

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

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "act-a1b2c3d4e5f6",
        "custom_id": "user-ext-001",
        "actor_type": "HUMAN",
        "display_name": "Alice Chen",
        "description": "Primary end user for the mobile app",
        "metadata": {
          "tier": "premium",
          "region": "us-west"
        },
        "created_at": "2025-03-10T08:00:00Z",
        "updated_at": "2025-03-10T08:00:00Z"
      },
      {
        "id": "act-f6e5d4c3b2a1",
        "custom_id": "system-intake",
        "actor_type": "ASSISTANT",
        "display_name": "Intake Bot",
        "description": "Automated intake system for onboarding flows",
        "metadata": {},
        "created_at": "2025-03-12T14:30:00Z",
        "updated_at": "2025-03-12T14:30:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiYWN0LWY2ZTVkNGMzYjJhMSJ9"
  }
}

​Query Parameters

​Response

Query Parameters

Response