PINECONE_API_KEY="YOUR_API_KEY"
JOB_ID="670e8400-e29b-41d4-a716-446655440001"
curl "https://api.pinecone.io/conversion-jobs/$JOB_ID" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-07" \
-H 'accept: application/json'
{
"conversion_job_id": "670e8400-e29b-41d4-a716-446655440001",
"source_index_id": "670e8400-e29b-41d4-a716-446655440000",
"target_index_name": "example-index-docs",
"target_index_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "InProgress",
"created_at": "2026-10-07T10:30:00.000Z",
"source_index_name": "example-index",
"error_mode": {
"on_error": "abort"
},
"percent_complete": 42.5,
"records_converted": 425000,
"records_skipped": 0,
"error": "Record doc-17: the metadata value for full-text search field `chunk_text` is a number, not a string.",
"completed_at": "2026-10-07T11:05:00.000Z"
}Invalid API key{
"error": {
"code": "PERMISSION_DENIED",
"message": "Access denied: Permission control::backups::list is required"
},
"status": 403
}{
"error": {
"code": "NOT_FOUND",
"message": "Conversion job 670e8400-e29b-41d4-a716-446655440001 not found."
},
"status": 404
}{
"error": {
"code": "UNKNOWN",
"message": "Internal server error"
},
"status": 500
}Describe a conversion job
Get the status and progress of a conversion job.
PINECONE_API_KEY="YOUR_API_KEY"
JOB_ID="670e8400-e29b-41d4-a716-446655440001"
curl "https://api.pinecone.io/conversion-jobs/$JOB_ID" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-07" \
-H 'accept: application/json'
{
"conversion_job_id": "670e8400-e29b-41d4-a716-446655440001",
"source_index_id": "670e8400-e29b-41d4-a716-446655440000",
"target_index_name": "example-index-docs",
"target_index_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "InProgress",
"created_at": "2026-10-07T10:30:00.000Z",
"source_index_name": "example-index",
"error_mode": {
"on_error": "abort"
},
"percent_complete": 42.5,
"records_converted": 425000,
"records_skipped": 0,
"error": "Record doc-17: the metadata value for full-text search field `chunk_text` is a number, not a string.",
"completed_at": "2026-10-07T11:05:00.000Z"
}Invalid API key{
"error": {
"code": "PERMISSION_DENIED",
"message": "Access denied: Permission control::backups::list is required"
},
"status": 403
}{
"error": {
"code": "NOT_FOUND",
"message": "Conversion job 670e8400-e29b-41d4-a716-446655440001 not found."
},
"status": 404
}{
"error": {
"code": "UNKNOWN",
"message": "Internal server error"
},
"status": 500
}PINECONE_API_KEY="YOUR_API_KEY"
JOB_ID="670e8400-e29b-41d4-a716-446655440001"
curl "https://api.pinecone.io/conversion-jobs/$JOB_ID" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-07" \
-H 'accept: application/json'
Authorizations
Headers
Required date-based version header
Path Parameters
The ID of the conversion job to describe.
Response
The status and progress of the conversion job.
The status and progress of a job that converts a vector index into a document index.
Identifies the job when describing or cancelling it.
"670e8400-e29b-41d4-a716-446655440001"
Identifies the vector index the job reads from. Stays set after that index is deleted.
"670e8400-e29b-41d4-a716-446655440000"
Name of the document index the job fills.
"example-index-docs"
ID of the document index the job fills.
"123e4567-e89b-12d3-a456-426614174000"
Status of the conversion job.
Possible values: Pending, InProgress, Completed, Failed, or Cancelled.
"InProgress"
Timestamp when the conversion job was created.
"2026-10-07T10:30:00.000Z"
Name of the index being converted. null once that index has been deleted.
"example-index"
How a conversion handles a source record the new index cannot take, such as a record whose metadata value for a full_text_search field is not a string. Records the schema can hold are never affected. If omitted, on_error is abort.
Show child attributes
Show child attributes
Progress of the conversion job, from 0 to 100. Absent until the job has started.
0 <= x <= 10042.5
The number of source records written to the document index so far.
x >= 0425000
The number of source records skipped because the document index cannot take them. Always 0 when error_mode.on_error is abort.
x >= 00
Why the job failed, when its status is Failed. null otherwise.
"Record doc-17: the metadata value for full-text search fieldchunk_textis a number, not a string."
Timestamp when the conversion job ended as Completed, Failed, or Cancelled. null until then.
"2026-10-07T11:05:00.000Z"
Was this page helpful?