Skip to main content
POST
/
v1
/
tasks
/
list
List Tasks
curl --request POST \
  --url https://api.mixpeek.com/v1/tasks/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "PENDING",
  "task_type": "api_namespaces_create",
  "filters": {
    "AND": [
      {
        "field": "name",
        "operator": "eq",
        "value": "John"
      },
      {
        "field": "age",
        "operator": "gte",
        "value": 30
      }
    ],
    "OR": [
      {
        "field": "status",
        "operator": "eq",
        "value": "active"
      },
      {
        "field": "role",
        "operator": "eq",
        "value": "admin"
      }
    ],
    "NOT": [
      {
        "field": "department",
        "operator": "eq",
        "value": "HR"
      },
      {
        "field": "location",
        "operator": "eq",
        "value": "remote"
      }
    ],
    "case_sensitive": true
  },
  "sort": {
    "field": "created_at",
    "direction": "desc"
  },
  "search": "<string>"
}'
{
  "results": [
    {
      "additional_data": {
        "batch_id": "btch_xyz789",
        "bucket_id": "bkt_products",
        "collection_ids": [
          "col_tier0",
          "col_tier1",
          "col_tier2"
        ],
        "current_tier": 1,
        "job_id": "ray_job_123",
        "namespace_id": "ns_abc123",
        "object_count": 10000,
        "sample_object_ids": [
          "obj_001",
          "obj_002",
          "obj_003",
          "obj_004",
          "obj_005"
        ],
        "total_tiers": 3
      },
      "description": "Multi-tier batch processing task in progress (tier 1 of 3) with 10k objects",
      "inputs": [
        "batch_xyz789"
      ],
      "status": "IN_PROGRESS",
      "task_id": "2d322a05-3178-4eca-aac6-b82b0a0313aa",
      "task_type": "api_buckets_batches_process"
    }
  ],
  "pagination": {
    "total": 123,
    "page": 123,
    "page_size": 123,
    "total_pages": 123,
    "next_page": "<string>",
    "previous_page": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Headers

Authorization
string
required
Examples:

Query Parameters

limit
integer | null
offset
integer | null

Body

application/json
status
enum<string> | null
Available options:
PENDING,
IN_PROGRESS,
PROCESSING,
COMPLETED,
COMPLETED_WITH_ERRORS,
FAILED,
CANCELED,
UNKNOWN,
SKIPPED,
DRAFT,
ACTIVE,
ARCHIVED,
SUSPENDED
task_type
enum<string> | null
Available options:
api_namespaces_create,
api_buckets_objects_create,
api_buckets_delete,
api_buckets_batches_process,
api_buckets_batches_submit,
api_buckets_uploads_create,
api_buckets_uploads_confirm,
api_buckets_uploads_batch_confirm,
api_taxonomies_create,
api_taxonomies_execute,
api_taxonomies_materialize,
api_evaluations_run,
api_evaluations_dataset_create,
engine_feature_extractor_run,
engine_inference_run,
engine_object_processing,
engine_cluster_build,
thumbnail,
video_segment,
materialize
filters
object | null
sort
object | null

Response

results
TaskResponse · object[]
required
pagination
object
required