ドキュメント

Jobs

Track and manage background processing jobs created by bucket uploads and other async operations.

List Jobs

bash# All jobs
curl https://api.schift.io/v1/jobs \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

# Filter by bucket
curl "https://api.schift.io/v1/jobs?bucket_id=abc123" \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

# Filter by status
curl "https://api.schift.io/v1/jobs?status=processing" \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

Query Param	Type	Description
`bucket_id`	string	Filter jobs by bucket
`status`	string	Filter by status: `queued`, `processing`, `completed`, `failed`

Get Job

bashcurl https://api.schift.io/v1/jobs/{job_id} \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

Cancel Job

Cancel a queued job before processing starts. Held credits are released.

bashcurl -X POST https://api.schift.io/v1/jobs/{job_id}/cancel \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

Returns {"status": "cancelled", "refunded": 0.25}. Only queued jobs can be cancelled — jobs already processing will return 400.

Reprocess Job

Retry a failed job. The original file is re-processed from storage.

bashcurl -X POST https://api.schift.io/v1/jobs/{job_id}/reprocess \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

Job lifecycle

Jobs progress through: queued → extracting → chunking → embedding → indexing → completed. If any step fails, the job moves to failed and can be retried with reprocess.