Get Environment Connection

get/v1/environments/{deviceId}

Get a specific environment connection by deviceId

Path ParametersExpand Collapse

deviceId: string

ReturnsExpand Collapse

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

Get Environment Connection

curl https://api.letta.com/v1/environments/$DEVICE_ID \
    -H "Authorization: Bearer $LETTA_API_KEY"

{
  "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"
}

Returns Examples

{
  "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"
}