List sessions for an agent

Lists agent sessions for one agent. Agent managers can see all sessions; other callers only see sessions they can access through their own chats or readable tasks.

GET/agents/{id}/runs

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Query parameters

targetTypestring

Allowed:tasktaskCommentappChatslackThreadeditorSessionautomationRun

statusstring

Allowed:queuedrunningwaitingInputwaitingApprovaldonefailedcanceled

minestring

When true, return only sessions owned by the current user. Non-admin callers are always limited to their accessible sessions.

fromstring

ISO date lower bound for run creation time.

tostring

ISO date upper bound for run creation time.

limitstring

Maximum sessions to return, capped at 100.

Responses

200

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*targetTypequerystatusqueryminequeryWhen true, return only sessions owned by the current user. Non-admin callers are always limited to their accessible sessions.fromqueryISO date lower bound for run creation time.toqueryISO date upper bound for run creation time.limitqueryMaximum sessions to return, capped at 100.

Request

curl -X GET "https://leadtime.app/api/public/agents/string/runs" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/agents/string/runs", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/agents/string/runs",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

No example response.