List active agents
Without limit or cursor, returns every active agent, newest created
first; only the 50 agents with the newest sessions carry a latest-turn
preview. With either parameter, returns one page ordered by
activityAt (newest first), every row with its own preview, plus
nextCursor/hasMore. activityAt only increases, so walking the
cursor never repeats a row. Order is most-recent activity first; an
agent that becomes active during a walk moves to the head and is
returned by a fresh first-page read, not by later pages.
curl --request GET \
--url https://api.lusor.ai/v1/agents \
--header 'X-Api-Key: <api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.lusor.ai/v1/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/agents"
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": "<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.
Opaque anchor from the previous page's nextCursor; a malformed cursor is a 400. Order is most-recent activity first; an agent that becomes active during a walk moves to the head and is returned by a fresh first-page read, not by later pages.
512Agents per page. Defaults to 50 when only cursor is given. Order is most-recent activity first; an agent that becomes active during a walk moves to the head and is returned by a fresh first-page read, not by later pages.
1 <= x <= 100Was this page helpful?
curl --request GET \
--url https://api.lusor.ai/v1/agents \
--header 'X-Api-Key: <api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.lusor.ai/v1/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/agents"
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": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}