GET/v1/tasks

List Tasks

Retrieve a paginated list of tasks for a specific squid

This endpoint retrieves a paginated list of tasks for a specific squid. You can choose between two query types to get different levels of detail.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Query Parameters

squid
Type:
string
Required:
Yes
Description:
The squid hash ID to list tasks for
type
Type:
string
Required:
No
Description:
Response detail level: 'url' (basic) or 'params' (detailed). Default: 'url'
page
Type:
integer
Required:
No
Description:
Page number for pagination. Default: 1
limit
Type:
integer
Required:
No
Description:
Results per page. Default: 50, Max: 100

Response Field Explanations

total_results
integer
Total number of tasks
Example: 2
limit
integer
Maximum results per page
Example: 50
page
integer
Current page number
Example: 1
total_pages
integer
Total number of pages
Example: 1
data
array
Array of task objects
Example: [...]
data[].id
string
Unique task identifier
Example: 6b9d3afdf4e76df374915a50d7a495c4
data[].created_at
string
Task creation timestamp
Example: 2025-03-05T09:24:49.581177
data[].is_active
boolean
Whether the task is active
Example: true
data[].params
object
Task parameters
Example: {url: ...}
next
stringnull
URL for next page (null if last page)
Example: null
previous
stringnull
URL for previous page (null if first page)
Example: null
Pro Tip

Pro Tip

Use type=url for a quick overview of tasks, or type=params when you need full parameter details.
Note

Note

Results are paginated. Use the next and previous URLs to navigate through large task lists.
Pro Tip

Pro Tip

Check is_active to identify tasks that are ready to run vs. disabled tasks.