List tasks
Returns a paginated list of Bot execution tasks.
Filtering
- Use
statusto filter by task status. - Use
bot_idto list tasks created from a specific Bot. - Use
bot_nameto search by Bot name using a contains match. - Use
created_at_from/created_at_tofor inclusive task creation time bounds in ISO 8601 format.
Pagination
Use page and limit. The response includes total_pages and total_count.
Normal Bot runs can include bot_id and bot_name. Official template runs omit template source fields and internal copied Bot IDs.
Authorizations
Send your API key in the Authorization header as Bearer <API_KEY>.
Query Parameters
Optional public bot identifier filter.
Optional bot name keyword (fuzzy match, contains).
Filter tasks by status. Public lifecycle status of a bot run.
created, running, finished, canceled, pausing, paused, failed Lower bound of task creation time (inclusive). ISO 8601 format, e.g. 2024-01-01T00:00:00Z.
Upper bound of task creation time (inclusive). ISO 8601 format, e.g. 2024-12-31T23:59:59Z.
Page number to retrieve (starts at 1).
x >= 1Number of tasks per page (max 100).
1 <= x <= 100
