Skip to main content
GET
/
v1
/
analytics
/
performance
/
batches
/
{batch_id}
/
diagnostics
Get Batch Diagnostics
curl --request GET \
  --url https://api.mixpeek.com/v1/analytics/performance/batches/{batch_id}/diagnostics
{
  "batch_id": "<string>",
  "batch_name": "<string>",
  "status": "<string>",
  "bucket_id": "<string>",
  "current_tier": 0,
  "total_tiers": 1,
  "overall_progress": 0,
  "created_at": "2023-11-07T05:31:56Z",
  "submitted_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "duration_seconds": 123,
  "estimated_completion": "2023-11-07T05:31:56Z",
  "tiers": [
    {
      "tier_num": 123,
      "status": "<string>",
      "task_id": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "duration_seconds": 123,
      "progress": {
        "processed_documents": 0,
        "total_documents": 0,
        "percentage": 0
      },
      "ray_job_id": "<string>",
      "ray_dashboard_url": "<string>",
      "error": "<string>",
      "error_type": "<string>"
    }
  ],
  "collections": [
    {
      "collection_id": "<string>",
      "collection_name": "<string>",
      "status": "<string>",
      "document_count": 0,
      "expected_documents": 123
    }
  ],
  "performance_summary": {},
  "insights": [
    {
      "type": "<string>",
      "severity": "<string>",
      "message": "<string>",
      "stage": "<string>",
      "metric_value": 123,
      "recommendation": "<string>"
    }
  ],
  "has_failures": false,
  "failed_tier_count": 0,
  "total_objects": 0,
  "next_actions": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string

Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Example:

"Bearer YOUR_MIXPEEK_API_KEY"

​
authorization
string
​
X-Namespace
string

Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like 'my-namespace'. Falls back to ?namespace= query parameter if the header is omitted.

Examples:

"ns_abc123def456"

"production"

"my-namespace"

Path Parameters

​
batch_id
string
required

Response

Successful Response

Comprehensive batch diagnostics response.

Combines batch status, task progress, collection info, and performance insights into a single response for easy frontend rendering.

​
batch_id
string
required

Batch ID

​
batch_name
string
required

Batch name

​
status
string
required

Overall batch status

​
bucket_id
string
required

Source bucket ID

​
current_tier
integer
default:0

Current tier being processed

​
total_tiers
integer
default:1

Total number of tiers

​
overall_progress
number
default:0

Overall progress percentage (0-100)

​
created_at
string<date-time> | null

When batch was created

​
submitted_at
string<date-time> | null

When batch was submitted

​
started_at
string<date-time> | null

When processing started

​
completed_at
string<date-time> | null

When processing completed

​
duration_seconds
number | null

Total duration in seconds

​
estimated_completion
string<date-time> | null

Estimated completion time

​
tiers
TierDiagnostic · object[]

Diagnostic info for each tier

​
collections
CollectionDiagnostic · object[]

Status of target collections

​
performance_summary
Performance Summary · object

Performance metrics summary (available after completion)

​
insights
PerformanceInsight · object[]

Performance insights and recommendations

​
has_failures
boolean
default:false

Whether batch has any failures

​
failed_tier_count
integer
default:0

Number of failed tiers

​
total_objects
integer
default:0

Total objects in batch

​
next_actions
string[]

Recommended next steps for user