Create Workspace

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "My Research Workspace",
    "custom_id": "research-ws-001",
    "description": "Central workspace for research documents and notes",
    "metadata": {
      "team": "research",
      "priority": "high"
    }
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "ws-fe314186ccd18cde04d6af48a5afd79f",
    "name": "My Research Workspace",
    "description": "Central workspace for research documents and notes",
    "metadata": {
      "team": "research",
      "priority": "high"
    },
    "custom_id": "research-ws-001",
    "created_at": "2025-03-10T08:30:00Z",
    "updated_at": "2025-03-10T08:30:00Z"
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "My Research Workspace",
    "custom_id": "research-ws-001",
    "description": "Central workspace for research documents and notes",
    "metadata": {
      "team": "research",
      "priority": "high"
    }
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "ws-fe314186ccd18cde04d6af48a5afd79f",
    "name": "My Research Workspace",
    "description": "Central workspace for research documents and notes",
    "metadata": {
      "team": "research",
      "priority": "high"
    },
    "custom_id": "research-ws-001",
    "created_at": "2025-03-10T08:30:00Z",
    "updated_at": "2025-03-10T08:30:00Z"
  }
}

POST /openapi/memorylake/api/v3/workspaces

Creates a new workspace. Each workspace requires a custom_id that you define, which serves as a stable external identifier you can use to reference the workspace in your own systems.

Permission required: workspace:create

Request Body

string

required

Workspace name

string

required

Your own identifier for this workspace — the one it already has in your system. Must be unique within your tenant. Pass by_custom_id=true on later requests to address the workspace by it instead of by id. See Your own identifiers.

string

Workspace description

object

Arbitrary key-value metadata to attach to the workspace

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/workspaces' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "My Research Workspace",
    "custom_id": "research-ws-001",
    "description": "Central workspace for research documents and notes",
    "metadata": {
      "team": "research",
      "priority": "high"
    }
  }'

Response

object

Show Workspace object

string

Unique workspace identifier

string

Workspace name

string

Workspace description

object

Arbitrary key-value metadata attached to the workspace

string

Caller-defined unique identifier for external reference

string

Creation timestamp

string

Last update timestamp

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "ws-fe314186ccd18cde04d6af48a5afd79f",
    "name": "My Research Workspace",
    "description": "Central workspace for research documents and notes",
    "metadata": {
      "team": "research",
      "priority": "high"
    },
    "custom_id": "research-ws-001",
    "created_at": "2025-03-10T08:30:00Z",
    "updated_at": "2025-03-10T08:30:00Z"
  }
}

MemoryLake API

Memory Router API

Request Body

Response

​Request Body

​Response

Request Body

Response