Artifacts
Publisher

Create a signed large-upload session for publisher releases.

Publisher/admin only. Returns signed object-storage PUT URLs for declared files. Complete the session before passing largeUploadManifestId to POST /api/artifacts.

Inputs. No path or query fields are required. The request body schema lists accepted fields and required values.

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. Write and protocol operations can have separate route-specific limits. Read Retry-After and retry_after_s when present; do not infer a write allowance from the public read budget.

Example setup. 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. This example is not executed by documentation checks. Review the operation and obtain any required user consent before sending it.

post/api/upload-sessions

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/upload-sessions
  • Auth: HTTP bearer

Request body

ownerstring required
namestring required

Response

Upload session with signed PUT URLs

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
draftPatchobject required
linksobject
urlsobject

Changes

No recorded changes to this operation across all 2 revisions of this API.