Skip to main content
GET
/
scheduled-tasks
/
executions
List task execution history (or stats)
curl --request GET \
  --url https://asteragents.com/api/scheduled-tasks/executions \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 123,
    "scheduledTaskId": 123,
    "conversationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "completed",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

​
Authorization
string
header
required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

​
taskId
integer
​
limit
integer
default:50
​
stats
boolean

When true, returns aggregate counts instead of the execution list.

​
since
string<date-time>

ISO date-time; with stats=true, only count runs after this time.

Response

An array of executions, or (with stats=true) an object like { total, completed, failed, in_progress }.

​
id
integer
​
scheduledTaskId
integer
​
conversationId
string<uuid> | null

Thread id of the run — fetch the full transcript with GET /getConversation.

​
status
string
Example:

"completed"

​
createdAt
string<date-time>