A2A Integration - MemoryLake AI

MemoryLake implements the A2A (Agent-to-Agent) protocol by Google. If you are already familiar with A2A, you can use any A2A-compatible client to interact with MemoryLake agents. Refer to the A2A specification for the standard request and response schemas. Official SDKs are available at github.com/a2aproject.

Permission required: workspace:a2a

Base URL

https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/{workspaceId}/agents/{agentId}/a2a

Append standard A2A paths directly — for example POST {baseUrl}/message:send or GET {baseUrl}/tasks/{taskId}.

MemoryLake Extension

MemoryLake extends the standard A2A protocol through the metadata.memorylake namespace. Pass this object in the request metadata of message:send or message:stream to control how the agent interacts with MemoryLake’s memory layer. This is the key difference from a vanilla A2A server — these fields connect the agent to workspaces, projects, and actors in MemoryLake.

metadata.memorylake

object

required

MemoryLake-specific configuration. Without this, the agent runs without any memory context.

Hide Fields

actorId

string

Actor identifier representing the end user. Facts extracted from the conversation are associated with this actor, enabling per-user memory.

readWriteProjectId

string

Project the agent can both read from and write to. Extracted facts and conversation history are persisted to this project.

readOnlyProjectIds

array

Additional projects the agent can search (documents and facts) but not modify. Use this to give the agent access to shared knowledge bases.

subagentMapping

object

Maps subagent names (defined in the agent configuration) to concrete agent IDs. Allows dynamic routing of subagent calls at request time.

overrides

object

Runtime overrides for the agent’s configuration.

Show Override fields

model

string

Override the agent’s model (e.g. gpt-4o, claude-sonnet-4-20250514)

systemPromptOverride

string

Replace the agent’s system prompt for this request

modelParams

object

Override model parameters (e.g. temperature, max_tokens)

reasoning

object

Reasoning configuration

Show Reasoning fields

type

string

Reasoning type

budgetTokens

integer

Token budget for reasoning

capabilitiesOverride

array

Override the agent’s capabilities list

maxTurns

integer

Override the maximum number of turns

Example

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/agents/agt_r8k2m1n3/a2a/message:send' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "message": {
      "role": "user",
      "content": [
        { "text": "How do I configure two-factor authentication?" }
      ],
      "contextId": "ctx_m4n7p2q9"
    },
    "configuration": {
      "blocking": true,
      "historyLength": 10
    },
    "metadata": {
      "memorylake": {
        "actorId": "act_user_jane",
        "readWriteProjectId": "proj_def456",
        "readOnlyProjectIds": ["proj_shared_kb"],
        "overrides": {
          "model": "gpt-4o",
          "maxTurns": 5
        }
      }
    }
  }'

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces/ws_abc123/agents/agt_r8k2m1n3/a2a/message:stream' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -H 'Accept: text/event-stream' \
  -d '{
    "message": {
      "role": "user",
      "content": [
        { "text": "Summarize our last meeting notes" }
      ]
    },
    "metadata": {
      "memorylake": {
        "actorId": "act_user_jane",
        "readOnlyProjectIds": ["proj_meetings"]
      }
    }
  }'

​Base URL

​MemoryLake Extension

​Example

Base URL

MemoryLake Extension

Example