Create Boundary

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/boundaries' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "custom_id": "user-ext-001",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }'

{
  "success": true,
  "data": {
    "id": "bnd-5e8a2c71d94f4b3a8e6d0c2b7f1a9e34",
    "custom_id": "user-ext-001",
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/boundaries' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "custom_id": "user-ext-001",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }'

{
  "success": true,
  "data": {
    "id": "bnd-5e8a2c71d94f4b3a8e6d0c2b7f1a9e34",
    "custom_id": "user-ext-001",
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }
}

POST /openapi/memorylake/api/v3/boundaries

Creates a boundary in a workspace. Every reference in the request must belong to that workspace: projects must be in it, and the actor and agent must be bound to it and not deleted.

Permission required: boundary:create on the workspace, plus search permission on every project, actor and agent the request names — see Permissions

Request Body

string

required

Workspace the boundary belongs to. Cannot be changed later.

string

required

Display name, 1 to 255 characters.

string

Your own identifier for this boundary, up to 255 characters. Must be unique within your tenant, cannot be changed once set, and must not start with _sys_. Pass by_custom_id=true on Get Boundary to look the boundary up by it. See Your own identifiers.

string[]

Projects in scope. Omit or send an empty array to leave the scope not narrowed to particular projects.

string

ID of the actor — the person — in scope.

string

ID of the agent whose memories are in scope.

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/boundaries' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "custom_id": "user-ext-001",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }'

Response

object

Show Boundary

string

Boundary ID

string

Your own identifier for the boundary, if you set one

string

Workspace the boundary belongs to

string

Boundary name

string[]

Projects in scope. Absent when the scope is not narrowed to particular projects.

string

Actor in scope. Absent when none is set.

string

Agent whose memories are in scope. Absent when none is set.

This response does not include created_at or updated_at. Read them with Get Boundary.

Errors

Status	Error code	When
`400`	`INVALID_ARGUMENT`	A project is not in the workspace, or the actor or agent does not exist or is not bound to it. The message names the field.
`400`	`ACTOR_INACTIVE`	The actor or agent has been deleted
`403`	`ACCESS_DENIED`	You lack `boundary:create`, or search permission on something the request names
`404`	`NOT_FOUND`	The workspace does not exist
`409`	`CUSTOM_ID_CONFLICT`	Another boundary in your tenant already uses this `custom_id`

{
  "success": true,
  "data": {
    "id": "bnd-5e8a2c71d94f4b3a8e6d0c2b7f1a9e34",
    "custom_id": "user-ext-001",
    "workspace_id": "ws-8001856949ad4f6a5b6226f415ffa877",
    "name": "Alice Chen - Support Assistant",
    "project_ids": ["proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"],
    "human_actor_id": "actor-8d093c0578ffeb19f8fa10ea28ee9362",
    "agent_id": "agent-f8bf71ab17ed8eccad8c0e8ae708273f"
  }
}

MemoryLake API

Memory Router API

Request Body

Response

Errors

​Request Body

​Response

​Errors

Request Body

Response

Errors