Library

Save an artifact to the current principal's library.

Save an artifact to the current principal's library.

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/library

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/library
  • Auth: HTTP bearer

Request body

artifactIdstring required
collectionstring
notestring

Response

Saved artifact

idstring required
repostring required
ownerstring required
namestring required
typestring required
licensestring required
summarystring required
hostingStatusstring required
sourceUrlstring required
savedAtstring required
collectionstring

Optional user-defined library collection name.

notestring

Optional private note for the saved artifact.

Changes

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