Repository Public
1[2 {3 "provider": "openai",4 "object": "batch",5 "api_family": "batches",6 "status_field": "status",7 "states": {8 "validating": "Input file is being validated (format, model, file access). request_counts.total is 0 until validation passes.",9 "failed": "Terminal. Input validation failed; `errors.data[]` lists {code, message, param, line}. No output file.",10 "in_progress": "Requests are executing. request_counts.completed/failed increase.",11 "finalizing": "All requests done; output/error files are being written.",12 "completed": "Terminal. output_file_id (purpose batch_output) and possibly error_file_id are available; `usage` populated (batches created after 2025-09-07).",13 "expired": "Terminal. 24h window elapsed; finished requests are in output_file_id, unfinished ones in error_file_id with code batch_expired. Completed requests are billed.",14 "cancelling": "Cancel requested; in-flight requests finish (up to ~10 min).",15 "cancelled": "Terminal. Partial results (if any) available via output_file_id."16 },17 "initial": "validating",18 "terminal": ["completed", "failed", "expired", "cancelled"],19 "transitions": [20 ["validating", "failed"], ["validating", "in_progress"], ["in_progress", "finalizing"], ["finalizing", "completed"],21 ["in_progress", "expired"], ["validating", "cancelling"], ["in_progress", "cancelling"], ["cancelling", "cancelled"]22 ],23 "timestamps": ["created_at", "in_progress_at", "finalizing_at", "completed_at", "failed_at", "expired_at", "cancelling_at", "cancelled_at", "expires_at"],24 "observed": {25 "2026-09-18 1-request /v1/responses gpt-5.4-nano": "validating (t=0) -> in_progress (t=2s) -> finalizing (t=29s) -> completed (t=30s); usage {input 10, output 5}; output file expires_at = file created_at + output_expires_after.seconds",26 "2026-09-18 bogus input_file_id": "POST accepted (200, status validating) -> failed within ~60s with errors.data[0] = {code:'invalid_request', message:'Cannot find file …, or organization … does not have access to it.', param:'file_id', line:null}"27 },28 "status": ["DOCUMENTED", "LIVE_VERIFIED"],29 "sources": [30 {"url": "https://developers.openai.com/api/docs/guides/batch#4-check-the-status-of-a-batch", "retrieved_at": "2026-09-18"},31 {"url": "https://developers.openai.com/api/reference/resources/batches", "retrieved_at": "2026-09-18"}32 ]33 },34 {35 "provider": "openai",36 "object": "fine_tuning.job",37 "api_family": "fine_tuning",38 "status_field": "status",39 "states": {40 "validating_files": "Training/validation files are checked (format, token counts, moderation of images for vision SFT).",41 "queued": "Waiting for training capacity.",42 "running": "Training loop; events of type `metrics` are emitted per step; checkpoints created per epoch (SFT/DPO) or per validation step (RFT).",43 "succeeded": "Terminal. `fine_tuned_model` is set (ft:<base>:<org>:<suffix>:<id>), result_files available, trained_tokens set.",44 "failed": "Terminal. `error` {code, message, param} explains (e.g. invalid training file, safety-check failure).",45 "cancelled": "Terminal. Cancelled by POST …/cancel.",46 "paused": "RFT only (not in the OpenAPI enum): POST …/pause snapshots a checkpoint and stops; POST …/resume continues from it."47 },48 "initial": "validating_files",49 "terminal": ["succeeded", "failed", "cancelled"],50 "transitions": [51 ["validating_files", "queued"], ["validating_files", "failed"], ["queued", "running"], ["running", "succeeded"], ["running", "failed"],52 ["validating_files", "cancelled"], ["queued", "cancelled"], ["running", "cancelled"], ["running", "paused"], ["paused", "running"], ["paused", "cancelled"]53 ],54 "timestamps": ["created_at", "finished_at", "estimated_finish"],55 "observed": {56 "2026-09-18": "Could not observe: POST /v1/fine_tuning/jobs -> 403 code training_not_available (org not allowed to create jobs; platform winding down). GET list returns empty; bogus ids -> 404 fine_tune_not_found."57 },58 "status": ["DOCUMENTED", "DEPRECATED", "ACCOUNT_RESTRICTED"],59 "sources": [60 {"url": "https://developers.openai.com/api/reference/resources/fine_tuning", "retrieved_at": "2026-09-18"},61 {"url": "https://developers.openai.com/api/docs/guides/reinforcement-fine-tuning#pausing-and-resuming-jobs", "retrieved_at": "2026-09-18"},62 {"url": "https://developers.openai.com/api/docs/deprecations#update-to-openais-self-serve-fine-tuning", "retrieved_at": "2026-09-18"}63 ]64 },65 {66 "provider": "openai",67 "object": "eval.run",68 "api_family": "evals",69 "status_field": "status",70 "states": {71 "queued": "Run accepted; items not yet processed.",72 "in_progress": "Sampling (if data_source is completions/responses) and grading output items.",73 "completed": "Terminal. result_counts {total, errored, failed, passed}, per_testing_criteria_results[], per_model_usage[] (empty array when no sampling) and report_url are final.",74 "failed": "Terminal. `error` {code, message} set.",75 "canceled": "Terminal. Cancelled via POST /v1/evals/{eval_id}/runs/{run_id} (American spelling in the API filter enum)."76 },77 "initial": "queued",78 "terminal": ["completed", "failed", "canceled"],79 "transitions": [["queued", "in_progress"], ["in_progress", "completed"], ["in_progress", "failed"], ["queued", "canceled"], ["in_progress", "canceled"]],80 "output_item_status": {"pass": "all graders passed", "fail": "at least one grader failed"},81 "observed": {82 "2026-09-18 jsonl file_content, 3 items, pre-filled sample, no model sampling": "queued (t=0) -> in_progress (t≈0.3s) -> completed (t≈3.6s); POST cancel on the completed run returned 200 and status stayed completed; GET runs?status=completed lagged (0 items right after completion)."83 },84 "status": ["DOCUMENTED", "DEPRECATED", "LIVE_VERIFIED"],85 "sources": [86 {"url": "https://developers.openai.com/api/reference/resources/evals", "retrieved_at": "2026-09-18"},87 {"url": "https://developers.openai.com/api/docs/guides/evals#analyze-the-results", "retrieved_at": "2026-09-18"}88 ]89 },90 {91 "provider": "openai",92 "object": "vector_store.file",93 "api_family": "vector_stores",94 "status_field": "status",95 "states": {96 "in_progress": "File is being parsed, chunked, embedded and indexed.",97 "completed": "Terminal. Searchable; usage_bytes reflects indexed size (larger than the raw file).",98 "failed": "Terminal. last_error {code: server_error | unsupported_file | invalid_file, message}.",99 "cancelled": "Terminal. Parent file batch was cancelled before this file finished."100 },101 "initial": "in_progress",102 "terminal": ["completed", "failed", "cancelled"],103 "transitions": [["in_progress", "completed"], ["in_progress", "failed"], ["in_progress", "cancelled"]],104 "observed": {"2026-09-18 200-byte txt, static 100/20": "in_progress -> completed after ~7.6s; usage_bytes 1203"},105 "status": ["DOCUMENTED", "LIVE_VERIFIED"],106 "sources": [{"url": "https://developers.openai.com/api/reference/resources/vector_stores/subresources/files", "retrieved_at": "2026-09-18"}]107 },108 {109 "provider": "openai",110 "object": "vector_store.file_batch",111 "api_family": "vector_stores",112 "status_field": "status",113 "states": {114 "in_progress": "Some files still indexing (file_counts.in_progress > 0).",115 "completed": "Terminal. All files reached a terminal state (some may be failed).",116 "failed": "Terminal. Batch-level failure.",117 "cancelled": "Terminal. POST …/cancel; remaining files become cancelled."118 },119 "initial": "in_progress",120 "terminal": ["completed", "failed", "cancelled"],121 "transitions": [["in_progress", "completed"], ["in_progress", "failed"], ["in_progress", "cancelled"]],122 "observed": {"2026-09-18 1 file": "in_progress -> completed after ~4s; POST cancel on the completed batch -> HTTP 500 server_error"},123 "status": ["DOCUMENTED", "LIVE_VERIFIED"],124 "sources": [{"url": "https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches", "retrieved_at": "2026-09-18"}]125 },126 {127 "provider": "openai",128 "object": "vector_store",129 "api_family": "vector_stores",130 "status_field": "status",131 "states": {132 "in_progress": "Files passed at creation (file_ids) are still indexing.",133 "completed": "Ready for search / file_search (an empty store is created directly in this state).",134 "expired": "Terminal. expires_after policy elapsed since last_active_at; all vector_store.file objects deleted, no more storage billing."135 },136 "initial": "completed (no files) | in_progress (with file_ids)",137 "terminal": ["expired"],138 "transitions": [["in_progress", "completed"], ["completed", "in_progress"], ["completed", "expired"]],139 "observed": {"2026-09-18": "created empty -> status completed immediately; expires_at = created_at + days*86400 with anchor last_active_at"},140 "status": ["DOCUMENTED", "LIVE_VERIFIED"],141 "sources": [{"url": "https://developers.openai.com/api/reference/resources/vector_stores", "retrieved_at": "2026-09-18"}, {"url": "https://developers.openai.com/api/docs/guides/retrieval#expiration-policies", "retrieved_at": "2026-09-18"}]142 },143 {144 "provider": "openai",145 "object": "upload",146 "api_family": "uploads",147 "status_field": "status",148 "states": {149 "pending": "Accepting Parts (POST …/parts). Expires one hour after creation (expires_at = created_at + 3600).",150 "completed": "Terminal. POST …/complete succeeded; `file` holds the resulting File object (usable like any uploaded file).",151 "cancelled": "Terminal. POST …/cancel; adding parts afterwards -> 400 'Upload status is already in a cancelled state'.",152 "expired": "Terminal. Not completed within the hour."153 },154 "initial": "pending",155 "terminal": ["completed", "cancelled", "expired"],156 "transitions": [["pending", "completed"], ["pending", "cancelled"], ["pending", "expired"]],157 "observed": {"2026-09-18": "pending -> completed (1 part, 192 bytes, purpose user_data); pending -> cancelled; expires_at observed = created_at + 3600 even when expires_after {seconds: 3600} is passed"},158 "status": ["DOCUMENTED", "LIVE_VERIFIED"],159 "sources": [{"url": "https://developers.openai.com/api/reference/resources/uploads", "retrieved_at": "2026-09-18"}]160 },161 {162 "provider": "openai",163 "object": "file",164 "api_family": "files",165 "status_field": "status (deprecated field)",166 "states": {167 "uploaded": "Legacy: received, not yet processed.",168 "processed": "Legacy: ready. Every file created in the 2026-09-18 tests was returned directly as processed.",169 "error": "Legacy: processing failed (see status_details, also deprecated)."170 },171 "initial": "processed (observed)",172 "terminal": ["processed", "error"],173 "transitions": [["uploaded", "processed"], ["uploaded", "error"]],174 "observed": {"2026-09-18": "status 'processed' immediately for txt/jsonl uploads and for the Upload-completed file; expiry is via expires_at (batch purpose default +30d, else null unless expires_after given)"},175 "status": ["DOCUMENTED", "DEPRECATED", "LIVE_VERIFIED"],176 "sources": [{"url": "https://developers.openai.com/api/reference/resources/files", "retrieved_at": "2026-09-18"}]177 }178]179