Skip to content
Letta Platform Letta Platform Letta Docs
Sign up

List Environment Connections

get/v1/environments

List all active environment connections for the organization

Query ParametersExpand Collapse
after: optional string
limit: optional string
onlineOnly: optional string
source: optional "local" or "remote"
Accepts one of the following:
"local"
"remote"
userId: optional string
ReturnsExpand Collapse
connections: array of object { id, connectedAt, connectionId, 11 more }
id: string
connectedAt: number
connectionId: string
connectionName: string
deviceId: string
firstSeenAt: number
lastHeartbeat: number
lastSeenAt: number
organizationId: string
podId: string
apiKeyOwner: optional string
currentMode: optional "default" or "standard" or "acceptEdits" or 2 more
Accepts one of the following:
"default"
"standard"
"acceptEdits"
"bypassPermissions"
"unrestricted"
metadata: optional object { gitBranch, lettaCodeVersion, nodeVersion, 2 more }
gitBranch: optional string
lettaCodeVersion: optional string
nodeVersion: optional string
os: optional string
workingDirectory: optional string
userId: optional string
hasNextPage: boolean
List Environment Connections
curl https://api.letta.com/v1/environments \
    -H "Authorization: Bearer $LETTA_API_KEY"
{
  "connections": [
    {
      "id": "id",
      "connectedAt": 0,
      "connectionId": "connectionId",
      "connectionName": "connectionName",
      "deviceId": "deviceId",
      "firstSeenAt": 0,
      "lastHeartbeat": 0,
      "lastSeenAt": 0,
      "organizationId": "organizationId",
      "podId": "podId",
      "apiKeyOwner": "apiKeyOwner",
      "currentMode": "default",
      "metadata": {
        "gitBranch": "gitBranch",
        "lettaCodeVersion": "lettaCodeVersion",
        "nodeVersion": "nodeVersion",
        "os": "os",
        "workingDirectory": "workingDirectory"
      },
      "userId": "userId"
    }
  ],
  "hasNextPage": true
}
Returns Examples
{
  "connections": [
    {
      "id": "id",
      "connectedAt": 0,
      "connectionId": "connectionId",
      "connectionName": "connectionName",
      "deviceId": "deviceId",
      "firstSeenAt": 0,
      "lastHeartbeat": 0,
      "lastSeenAt": 0,
      "organizationId": "organizationId",
      "podId": "podId",
      "apiKeyOwner": "apiKeyOwner",
      "currentMode": "default",
      "metadata": {
        "gitBranch": "gitBranch",
        "lettaCodeVersion": "lettaCodeVersion",
        "nodeVersion": "nodeVersion",
        "os": "os",
        "workingDirectory": "workingDirectory"
      },
      "userId": "userId"
    }
  ],
  "hasNextPage": true
}