List agents recoverable within the 30-day restore window
Lists archived agents in the authenticated tenant and selected workspace
with a non-null purgeAfter strictly later than the query time. Expired
and already-purged agents are excluded. This read does not purge rows.
Ordered by purgeAfter ascending (nearest deadline first), then id.
Each entry includes identity/profile fields, archivedAt, purgeAfter,
and minimal thread preview (lastTurnAt, lastTurnSnippet); no full
turn history is returned. Pass an entry’s id to
POST /v1/agents/{id}/restore in the same workspace before its deadline.
Active roster and detail endpoints continue to hide archived agents.
API keys default to their bound workspace and cannot select another
workspace.
curl --request GET \
--url https://api.lusor.ai/v1/agents/trash \
--header 'X-Api-Key: <api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.lusor.ai/v1/agents/trash', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/agents/trash"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"avatar": "<string>",
"description": "<string>",
"model": "<string>",
"archivedAt": "2023-11-07T05:31:56Z",
"purgeAfter": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"lastTurnAt": "2023-11-07T05:31:56Z",
"lastTurnSnippet": "<string>",
"activityAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>",
"hasMore": true
}{
"error": "validation_error",
"details": {}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
Workspace API key, created in the dashboard under Settings → API Keys.
Query Parameters
Workspace the request is scoped to. Optional for API keys: a key is bound to one workspace when it is created, and naming any other workspace returns an opaque 404.
Was this page helpful?
curl --request GET \
--url https://api.lusor.ai/v1/agents/trash \
--header 'X-Api-Key: <api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.lusor.ai/v1/agents/trash', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/agents/trash"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"avatar": "<string>",
"description": "<string>",
"model": "<string>",
"archivedAt": "2023-11-07T05:31:56Z",
"purgeAfter": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"lastTurnAt": "2023-11-07T05:31:56Z",
"lastTurnSnippet": "<string>",
"activityAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>",
"hasMore": true
}{
"error": "validation_error",
"details": {}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}