Skip to main content
GET
/
v1
/
admin
/
hosted-uploads
/
{upload_session_id}
/
readiness
Get hosted upload readiness (admin)
curl --request GET \
  --url https://api.withsplendor.com/v1/admin/hosted-uploads/{upload_session_id}/readiness \
  --header 'Authorization: Bearer <token>' \
  --header 'x-splendor-tenant-id: <x-splendor-tenant-id>'
{
  "bucket": "acme-uploads",
  "completed_at": "2026-01-15T09:30:00Z",
  "created_at": "2026-01-15T09:30:00Z",
  "dataset_id": "app-logs",
  "documents": {
    "expected": 1240000,
    "index_committed": 1240000,
    "parsed": 1240000,
    "schema_observed": 1240000,
    "semantic_embedded": 1240000,
    "semantic_total": 1240000
  },
  "error_code": null,
  "error_message": null,
  "etag": "\"abc123\"",
  "failed_at": null,
  "ingest_run_id": "ing_01H8Z3",
  "ingest_status": "ready",
  "key": "uploads/ups_01H8Z3/data.jsonl",
  "lifecycle": {
    "reasons": [],
    "repairable": false,
    "state": "ready"
  },
  "queued_at": "2026-01-15T09:30:00Z",
  "ready_for": {
    "semantic_search": true,
    "sql_search": true,
    "text_search": true
  },
  "semantic_ready_at": "2026-01-15T09:30:00Z",
  "source_id": 12,
  "started_at": "2026-01-15T09:30:00Z",
  "text_indexed_at": "2026-01-15T09:30:00Z",
  "updated_at": "2026-01-15T09:30:00Z",
  "upload_session_id": "ups_01H8Z3",
  "upload_status": "completed"
}

Authorizations

Authorization
string
header
required

API token issued from the Splendor console.

Headers

x-splendor-tenant-id
string
required

Selects the tenant (workspace) the request acts within.

Path Parameters

upload_session_id
string
required

Response

Successful Response

bucket
string
required
completed_at
string<date-time> | null
required
created_at
string<date-time>
required
dataset_id
string
required
documents
IngestReadinessDocumentCounts · object
required
error_code
string | null
required
error_message
string | null
required
etag
string | null
required
failed_at
string<date-time> | null
required
ingest_run_id
string
required
ingest_status
string
required
key
string
required
lifecycle
IngestLifecycleDiagnostic · object
required
queued_at
string<date-time> | null
required
ready_for
IngestReadinessReadyFor · object
required
semantic_ready_at
string<date-time> | null
required
source_id
integer
required
started_at
string<date-time> | null
required
text_indexed_at
string<date-time> | null
required
updated_at
string<date-time>
required
upload_session_id
string
required
upload_status
string
required