Destroy Lens Session - Archetype AI Documentation

curl -X POST https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "lsn-250313c2177253cbaa7a73542edd90"
  }'

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

response = requests.post(
    "https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "session_id": "lsn-250313c2177253cbaa7a73542edd90"
    }
)

result = response.json()

if result.get("is_valid") == False:
    print(f"Error: {result['errors']}")
else:
    print(f"Session destroyed: {result['session_id']}")
    print(f"Duration: {result['session_duration_sec']} seconds")

const response = await fetch('https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.ATAI_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    session_id: 'lsn-250313c2177253cbaa7a73542edd90'
  })
});

const result = await response.json();

if (result.is_valid === false) {
  console.error('Error:', result.errors);
} else {
  console.log(`Session destroyed: ${result.session_id}`);
}

{
  "session_id": "lsn-2512078e5c9ce4d312a6681e771542",
  "lens_id": "lns-test-lens-3de60a5c",
  "last_update_timestamp": 1765095462.576972,
  "session_status": "SESSION_STATUS_DESTROYED",
  "session_runner": "lens_service:runner:lens-node-worker-node-abc123",
  "session_endpoint": "wss://api.u1.archetypeai.app/v0.5/lens/sessions/lsn-2512078e5c9ce4d312a6681e771542",
  "session_duration_sec": 53.79125928878784
}

{
  "errors": [
    "Missing session_id!"
  ]
}

{
  "errors": [
    "Invalid session_id: lsn-nonexistent-12345678"
  ]
}

{
  "errors": [
    {
      "code": "unauthorized_request",
      "message": "Unauthorized or invalid access.",
      "suggestion": "Provide valid authentication credentials and ensure they have the required permissions.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

POST

lens

sessions

destroy

curl -X POST https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "lsn-250313c2177253cbaa7a73542edd90"
  }'

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

response = requests.post(
    "https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "session_id": "lsn-250313c2177253cbaa7a73542edd90"
    }
)

result = response.json()

if result.get("is_valid") == False:
    print(f"Error: {result['errors']}")
else:
    print(f"Session destroyed: {result['session_id']}")
    print(f"Duration: {result['session_duration_sec']} seconds")

const response = await fetch('https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.ATAI_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    session_id: 'lsn-250313c2177253cbaa7a73542edd90'
  })
});

const result = await response.json();

if (result.is_valid === false) {
  console.error('Error:', result.errors);
} else {
  console.log(`Session destroyed: ${result.session_id}`);
}

{
  "session_id": "lsn-2512078e5c9ce4d312a6681e771542",
  "lens_id": "lns-test-lens-3de60a5c",
  "last_update_timestamp": 1765095462.576972,
  "session_status": "SESSION_STATUS_DESTROYED",
  "session_runner": "lens_service:runner:lens-node-worker-node-abc123",
  "session_endpoint": "wss://api.u1.archetypeai.app/v0.5/lens/sessions/lsn-2512078e5c9ce4d312a6681e771542",
  "session_duration_sec": 53.79125928878784
}

{
  "errors": [
    "Missing session_id!"
  ]
}

{
  "errors": [
    "Invalid session_id: lsn-nonexistent-12345678"
  ]
}

{
  "errors": [
    {
      "code": "unauthorized_request",
      "message": "Unauthorized or invalid access.",
      "suggestion": "Provide valid authentication credentials and ensure they have the required permissions.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

Overview

This endpoint destroys an active lens session, closing any open connections and freeing up resources. Always destroy sessions when you’re done using them to avoid hitting concurrent session limits.

Request

session_id

string

required

The unique session ID to destroy. This is returned when creating a session.

Response

On success, returns the destroyed session record. Errors are returned with an HTTP 4xx status and an errors array (no is_valid field).

session_id

string

The ID of the destroyed session.

lens_id

string

The lens ID the session was attached to.

session_status

string

Final status of the session (typically SESSION_STATUS_DESTROYED).

session_runner

string

Identifier of the backend runner that hosted the session.

session_endpoint

string

WebSocket URL the session was reachable at.

last_update_timestamp

float

Unix timestamp of the last update to the session record.

session_duration_sec

float

Total duration the session was active in seconds.

curl -X POST https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "lsn-250313c2177253cbaa7a73542edd90"
  }'

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

response = requests.post(
    "https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "session_id": "lsn-250313c2177253cbaa7a73542edd90"
    }
)

result = response.json()

if result.get("is_valid") == False:
    print(f"Error: {result['errors']}")
else:
    print(f"Session destroyed: {result['session_id']}")
    print(f"Duration: {result['session_duration_sec']} seconds")

const response = await fetch('https://api.u1.archetypeai.app/v0.5/lens/sessions/destroy', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.ATAI_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    session_id: 'lsn-250313c2177253cbaa7a73542edd90'
  })
});

const result = await response.json();

if (result.is_valid === false) {
  console.error('Error:', result.errors);
} else {
  console.log(`Session destroyed: ${result.session_id}`);
}

{
  "session_id": "lsn-2512078e5c9ce4d312a6681e771542",
  "lens_id": "lns-test-lens-3de60a5c",
  "last_update_timestamp": 1765095462.576972,
  "session_status": "SESSION_STATUS_DESTROYED",
  "session_runner": "lens_service:runner:lens-node-worker-node-abc123",
  "session_endpoint": "wss://api.u1.archetypeai.app/v0.5/lens/sessions/lsn-2512078e5c9ce4d312a6681e771542",
  "session_duration_sec": 53.79125928878784
}

{
  "errors": [
    "Missing session_id!"
  ]
}

{
  "errors": [
    "Invalid session_id: lsn-nonexistent-12345678"
  ]
}

{
  "errors": [
    {
      "code": "unauthorized_request",
      "message": "Unauthorized or invalid access.",
      "suggestion": "Provide valid authentication credentials and ensure they have the required permissions.",
      "error_uid": "err-xxxxxxxx"
    }
  ]
}

Best Practices

Always clean up sessions: Implement proper cleanup in your code to ensure sessions are destroyed even if errors occur:

try:
    # Create and use session
    session = create_session(lens_id)
    process_data(session)
finally:
    # Always destroy the session
    destroy_session(session['session_id'])

Sessions that are not explicitly destroyed will:

Continue consuming your concurrent session quota
Timeout after 30 minutes of inactivity
May result in hitting rate limits for new session creation

Create Lens Session Get Sessions Info

⌘I

​Overview

​Request

​Response

​Best Practices

Overview

Request

Response

Best Practices