curl -X POST https://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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"
}
]
}
Lens API
Destroy Lens Session
Destroy an active lens session and free up resources
POST
/
lens
/
sessions
/
destroy
curl -X POST https://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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"
}
]
}
Requires version 1.1.5 or later of the Archetype platform.
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
Response
On success, returns the destroyed session record. Errors are returned with an HTTP 4xx status and anerrors array (no is_valid field).
curl -X POST https://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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://platform.u1.archetypeai.app/api/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
Was this page helpful?