Create Team

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/teams' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Example name",
    "api_key_name": "Example api key",
    "issue_api_key": true
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "team": {
      "created_at": 1760000000,
      "id": "7d9e7032509bd2d43c2eeec93bae86a2",
      "name": "Example name",
      "owner_principal_id": "284c4662589661476271ee7c94015dec",
      "type": "personal",
      "caller_role": "tenant_member"
    },
    "api_key": {
      "id": "b62967384a5222f7709e7ee5220e565f",
      "key": "sk-f6e5d4c3...redacted...b2a1",
      "key_prefix": "f6e5d4c3",
      "name": "Example name",
      "key_suffix": "b2a1"
    }
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/teams' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Example name",
    "api_key_name": "Example api key",
    "issue_api_key": true
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "team": {
      "created_at": 1760000000,
      "id": "7d9e7032509bd2d43c2eeec93bae86a2",
      "name": "Example name",
      "owner_principal_id": "284c4662589661476271ee7c94015dec",
      "type": "personal",
      "caller_role": "tenant_member"
    },
    "api_key": {
      "id": "b62967384a5222f7709e7ee5220e565f",
      "key": "sk-f6e5d4c3...redacted...b2a1",
      "key_prefix": "f6e5d4c3",
      "name": "Example name",
      "key_suffix": "b2a1"
    }
  }
}

POST /openapi/memorylake/admin/v1/teams

Creates a new org team owned by the API key’s owner (not by this key’s team). The owner must be a person who can sign in: keys of virtual members are refused (403). If issue_api_key is true, the response includes a new owner API key for that team; its secret is returned only on the first response — a retry with the same Idempotency-Key replays the team and the key’s metadata without the secret. Without an Idempotency-Key, a retry creates a second team. Creating a team counts toward the owner’s team limit (409 RESOURCE_LIMIT_EXCEEDED when reached) and grants the free plan when available. 403 also when team creation is disabled on this deployment.

High-risk operation. It takes effect immediately. Read what it changes, above, before you call it.

Permission required: none — any member’s key can call this

Headers

string

Optional. Retrying with the same value replays the first result. If an API key was issued, its secret is returned only on the first response.

Request Body

string

required

Display name for the new org team

string

Display name for the optional owner API key. Defaults to the team name plus ’ API key’.

boolean

If true, also create an owner API key in the new team and return its secret once.

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/admin/v1/teams' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Example name",
    "api_key_name": "Example api key",
    "issue_api_key": true
  }'

Response

object

Show Create Team object

object

The new team

Show Team object

integer

Creation time, Unix seconds

string

Stable identifier of this team

string

Display name

string

principal_id of the team owner (see the members list)

string

personal = single-user space, org = team with members

string

The calling key’s role in this team: tenant_owner | tenant_admin | tenant_member | <custom role>

object

One-time API key for the new team, present only when issue_api_key is true. The key secret is not returned on idempotent replay.

Show API Key Created object

string

Stable identifier of this API key

string

The full API key, including the sk- prefix. Save it now — read endpoints never return it.

string

First 8 characters of the key body

string

Display name

string

Last 4 characters of the key

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "team": {
      "created_at": 1760000000,
      "id": "7d9e7032509bd2d43c2eeec93bae86a2",
      "name": "Example name",
      "owner_principal_id": "284c4662589661476271ee7c94015dec",
      "type": "personal",
      "caller_role": "tenant_member"
    },
    "api_key": {
      "id": "b62967384a5222f7709e7ee5220e565f",
      "key": "sk-f6e5d4c3...redacted...b2a1",
      "key_prefix": "f6e5d4c3",
      "name": "Example name",
      "key_suffix": "b2a1"
    }
  }
}

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

Headers

Request Body

Response

Errors

​Headers

​Request Body

​Response

​Errors

Headers

Request Body

Response

Errors