Update IM Integration

curl -X PATCH 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations/8e6332af9d801f19496ca0f9fded5333' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": "bacb5a9d15867eca98ad566c546b2503",
    "credentials": {
      "appId": "example",
      "appKey": "example",
      "appSecret": "example",
      "appToken": "example",
      "botId": "example",
      "botToken": "example",
      "secret": "example"
    },
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "47e198610eb6f56441396b62501d1ccf",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    }
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "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"
  }
}

curl -X PATCH 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations/8e6332af9d801f19496ca0f9fded5333' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": "bacb5a9d15867eca98ad566c546b2503",
    "credentials": {
      "appId": "example",
      "appKey": "example",
      "appSecret": "example",
      "appToken": "example",
      "botId": "example",
      "botToken": "example",
      "secret": "example"
    },
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "47e198610eb6f56441396b62501d1ccf",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    }
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "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"
  }
}

PATCH /openapi/memorylake/admin/v1/integrations/{integration_id}

Changes an integration. Only the fields you send change; null is rejected. Omit credentials to keep them; send only a new secret to rotate it. The bot’s app identifier cannot change (422). New DingTalk, Feishu and Slack credentials are verified before saving, and the status returns to pending until the new connection is up. Changing a project reference needs the same project access as Create IM Integration.

Permission required: workspace:integration_manage on workspace_id

When you set read_write_project_id: project:mem_add on read_write_project_id
When you set read_only_project_ids: project:mem_search on read_only_project_ids

Path Parameters

string

required

Identifier of the integration

Headers

string

Optional. Retrying with the same value replays the first result. Credential values are not compared.

Request Body

string

Switch the answering agent. Ongoing IM conversations start over with the new agent; sending the current agent_id changes nothing.

object

Write-only. Omit to keep the stored credentials. Send only the values that change: a secret can be rotated alone. The app identifier (appKey / appId / botId, or the Slack team and bot user) cannot change — delete and recreate the integration to connect a different bot. DingTalk, Feishu and Slack credentials are verified with the platform before saving.

Show Integration Credentials object

string

Feishu: App ID. Identifies the bot; cannot change after creation.

string

DingTalk: Client ID (AppKey). Identifies the bot; cannot change after creation.

string

DingTalk: Client Secret (AppSecret). Feishu: App Secret.

string

Slack: App-Level Token (xapp-…) with connections:write.

string

WeCom: Bot ID of the intelligent robot. Identifies the bot; cannot change after creation.

string

Slack: Bot User OAuth Token (xoxb-…). Apps with token rotation enabled are not supported.

string

WeCom: Secret of the intelligent robot.

integer

Maximum messages handled per day; 0 = unlimited

array

Replace the datasets. [] removes them.

boolean

Connect (true) or disconnect (false) the bot

string

New display name

array

Replace the read-only projects. [] removes them.

string

New project for extracted memories

object

Replace the 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.

curl -X PATCH 'https://app.memorylake.ai/openapi/memorylake/admin/v1/integrations/8e6332af9d801f19496ca0f9fded5333' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": "bacb5a9d15867eca98ad566c546b2503",
    "credentials": {
      "appId": "example",
      "appKey": "example",
      "appSecret": "example",
      "appToken": "example",
      "botId": "example",
      "botToken": "example",
      "secret": "example"
    },
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "47e198610eb6f56441396b62501d1ccf",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    }
  }'

Response

object

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.

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "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"
  }
}

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
`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

Path Parameters

Headers

Request Body

Response

Errors

​Path Parameters

​Headers

​Request Body

​Response

​Errors

Path Parameters

Headers

Request Body

Response

Errors