Fetch upload-session state.

Inputs. Path, query and header fields are listed below. No request body is required.

Outputs. See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

Errors. API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

Rate limits. Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

Example setup. Use an identifier returned by the matching list, search or create operation. Sample identifiers are not a promise that a record exists. Set HUGGING_BAY_TOKEN to a credential with the role or scope stated by this operation. Reader tokens do not grant publisher or operator rights.

get/api/upload-sessions/{id}

Request

Base URL: https://huggingbay.xyz
URL: https://huggingbay.xyz/api/upload-sessions/{id}
Auth: HTTP bearer

Path parameters

idstring required

Query parameters

refresh'1'

Use refresh=1 to HEAD object storage and update progress/status.

Response

Upload session

schemaVersion'hugging-bay.upload-session.v1' required

idstring required

ownerstring required

namestring required

status'created' | 'pending' | 'completed' | 'canceled' | 'expired' required

storageProviderstring

createdAtstring

expiresAtstring

completedAtstring nullable

filesUploadSessionFile[] required(unresolved $ref)

draftPatchobject required

linksobject

urlsobject

Changes

No recorded changes to this operation across all 1 revision of this API.