Sources
Agent Docs

Queue a missing upstream source for indexing and mirror review.

Public demand-capture endpoint for supported upstream references. It creates or updates a sanitized moderation queue item and never returns contact, referrer, user-agent, visitor bucket, or digest data.

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

post/api/source-requests

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/source-requests
  • Auth: none declared

Request body

repostring required

Full upstream URL or owner/name reference.

source'huggingface' | 'modelscope' | 'github' | 'zenodo' | 'arxiv'
useCasestring
targetToolstring
desiredFilesstring[]
contactstring

Private operator-only contact hint. Never returned in public status responses.

Response

Existing request returned or source already indexed

schemaVersion'hugging-bay.source-request-status.v1' required
generatedAtstring required
idstring required
statusstring required
createdboolean
newRequestboolean
indexedboolean
artifactArtifactSummary (unresolved $ref)
actionsobject required
guidancestring[] required

Changes

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