openai_list_tasks
List async image tasks by filtering with task IDs, trace IDs, application ID, user ID, or time range. Returns a paginated list of tasks that were recorded with a callback URL.
Instructions
List async image tasks using batch query filters.
Returns a paginated list of async image task records. You must provide at
least one filter: ids, trace_ids, application_id, user_id, or a
created_at_min / created_at_max time window.
Note: tasks are only created when the original request included a
callback_url. Synchronous (non-callback) calls are not stored.
Use this when:
- You want to list multiple tasks at once
- You want to see all tasks for an application or user
Returns:
JSON object with 'items' array and 'count' field.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | List of task IDs to retrieve. | |
| type | No | Filter by upstream type. Options: 'images', 'images_generations', 'images_edits'. | |
| limit | No | Number of tasks per page. Default is 12. | |
| offset | No | Pagination offset. Default is 0. | |
| user_id | No | List all tasks belonging to the specified end user. | |
| trace_ids | No | List of custom trace IDs to retrieve. | |
| application_id | No | List all tasks belonging to the specified application. | |
| created_at_max | No | Latest task creation timestamp (Unix seconds, inclusive). | |
| created_at_min | No | Earliest task creation timestamp (Unix seconds, inclusive). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |