List IM Integrations

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "items": [
      {
        "agent_id": "9926a90400d85f0a54e9e195e915db44",
        "channel": "dingtalk",
        "created_at": 1760000000,
        "credentials_configured": false,
        "daily_message_limit": 1,
        "dataset_ids": [
          "3748f84ef0d2e877c0097b8f32d45cf0"
        ],
        "enabled": true,
        "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
        "id": "f58008acc066bab6dfb73de8efde8905",
        "name": "Example name",
        "read_only_project_ids": [
          "5af1515af082229ccfd68f981a6cf886"
        ],
        "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
        "settings": {
          "card_template_id": "870213bad9d43369a8af134b1b482d6e"
        },
        "status": "pending",
        "updated_at": 1760000000,
        "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
        "status_error": "example",
        "status_error_code": "credentials_invalid"
      }
    ],
    "continuation_token": "eyJvZmZzZXQiOjIwfQ",
    "total": 1
  }
}

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "items": [
      {
        "agent_id": "9926a90400d85f0a54e9e195e915db44",
        "channel": "dingtalk",
        "created_at": 1760000000,
        "credentials_configured": false,
        "daily_message_limit": 1,
        "dataset_ids": [
          "3748f84ef0d2e877c0097b8f32d45cf0"
        ],
        "enabled": true,
        "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
        "id": "f58008acc066bab6dfb73de8efde8905",
        "name": "Example name",
        "read_only_project_ids": [
          "5af1515af082229ccfd68f981a6cf886"
        ],
        "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
        "settings": {
          "card_template_id": "870213bad9d43369a8af134b1b482d6e"
        },
        "status": "pending",
        "updated_at": 1760000000,
        "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
        "status_error": "example",
        "status_error_code": "credentials_invalid"
      }
    ],
    "continuation_token": "eyJvZmZzZXQiOjIwfQ",
    "total": 1
  }
}

GET /openapi/memorylake/admin/v1/integrations

Lists the IM channel integrations in the workspaces you may manage, newest first. Integrations in other workspaces are left out (and not counted in total); filtering by a workspace you may not manage is refused. Credentials are never returned.

Permission required: depends on what you send:

When you set workspace_id: workspace:integration_manage on workspace_id

Query Parameters

integer

default:"20"

Number of items per page (1–100)

string

Token from the previous page. Opaque — do not construct or parse it.

string

Only integrations of this workspace

string

Only integrations answered by this agent

curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations' \
  -H 'Authorization: Bearer sk_xxxxxx'

Response

object

Show Load More Response Integration object

array

List of items in the current page

Show Integration object

string

Agent that answers messages sent to the bot

string

IM platform. One of: dingtalk, wecom, feishu, slack.

integer

Creation time, Unix seconds

boolean

Whether credentials are stored. Credentials themselves are write-only and never returned.

integer

Maximum messages this integration handles per day; 0 = unlimited

array

Open-data datasets the agent may use

boolean

Whether the integration should be connected

string

The bot’s identifier on the IM platform (DingTalk Client ID, Feishu App ID, WeCom Bot ID, Slack team:bot-user). Not a secret.

string

Identifier of the integration

string

Display name

array

Additional projects searched (read only)

string

Project that memories extracted from IM conversations are written to

object

Channel-specific settings

Show Integration Settings object

string

DingTalk only: AI card template id. Set it to stream replies into an interactive card; omit or send "" to reply with plain messages.

string

Connection state. pending right after a create or a credential change until the first connection attempt; poll Get IM Integration to follow it. One of: pending, connected, error, disabled.

integer

Last update time, Unix seconds

string

Workspace the integration belongs to. Fixed at creation.

string

Short normalized reason when status is error, for display (Chinese, the console’s wording; it may change). Never contains the platform’s raw response. Use status_error_code in programs.

string

Stable reason code, present whenever status_error is. credentials_invalid: the platform rejected the credentials (fix them); subscribe_rejected: WeCom refused the subscription — wrong credentials or the platform’s rate limit, retried automatically; preempted: another connection took over the bot, usually the same bot connected from another environment; timeout / disconnected / connection_aborted / connection_failed: connection problems, retried automatically; dependency_unavailable: a service this deployment depends on is down, retried automatically; dependency_misconfigured: this deployment lacks something the channel needs (WeCom needs Redis) — contact the operator; internal_error: a fault on our side; unknown: the reason was recorded before codes existed, and is replaced on the next connection attempt. New codes may be added; treat an unrecognised one like connection_failed.

string

Token to fetch the next page; absent on the last page

integer

Total number of items matching the filter across all pages; omitted when the count is unavailable

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "items": [
      {
        "agent_id": "9926a90400d85f0a54e9e195e915db44",
        "channel": "dingtalk",
        "created_at": 1760000000,
        "credentials_configured": false,
        "daily_message_limit": 1,
        "dataset_ids": [
          "3748f84ef0d2e877c0097b8f32d45cf0"
        ],
        "enabled": true,
        "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
        "id": "f58008acc066bab6dfb73de8efde8905",
        "name": "Example name",
        "read_only_project_ids": [
          "5af1515af082229ccfd68f981a6cf886"
        ],
        "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
        "settings": {
          "card_template_id": "870213bad9d43369a8af134b1b482d6e"
        },
        "status": "pending",
        "updated_at": 1760000000,
        "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
        "status_error": "example",
        "status_error_code": "credentials_invalid"
      }
    ],
    "continuation_token": "eyJvZmZzZXQiOjIwfQ",
    "total": 1
  }
}

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
`404`	The resource does not exist
`422`	The body or a parameter failed validation
`429`	Too many requests. Wait for the time in `Retry-After`
`500`	Server-side error

MemoryLake API

Memory Router API

Query Parameters

Response

Errors

​Query Parameters

​Response

​Errors

Query Parameters

Response

Errors