Sign in

v4

latestOpenAPI 3.1.02026-08-021957100.4 KB
Batch Embeddings

Cancel a batch job

Cancel a pending or processing batch job.

delete/v1/batch/{batch_id}

Path parameters

batch_idstring required

Response

Successful Response

batch_idstring required

Unique identifier for the batch job.

status'pending' | 'processing' | 'completed' | 'failed' | 'expired' | 'cancelled' required

Current status of the batch job.

modelstring required

The model used for embedding.

created_atstring required

ISO 8601 timestamp when job was created.

completed_atstring nullable

ISO 8601 timestamp when job completed (if finished).

expires_atstring nullable

ISO 8601 timestamp when output URL expires (created_at + 24h).

output_urlstring nullable

Signed URL to download output JSONL (24h expiry).

error_file_urlstring nullable

URL to download error JSONL for failed lines.

errorstring nullable

Error message if job failed.

Example response

{
  "batch_id": "batch_abc123",
  "completed_at": "2024-01-15T10:35:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "expires_at": "2024-01-16T10:30:00Z",
  "model": "jina-embeddings-v5-text-small",
  "output_url": "https://storage.googleapis.com/...",
  "stats": {
    "completed": 998,
    "failed": 2,
    "total": 1000
  },
  "status": "completed"
}