# huggingbay-xyz Mirrors API

**Canonical:** https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-mirrors-api/  
**Provider:** huggingbay-xyz — https://apis.io/providers/huggingbay-xyz/  
**Base URL:** https://huggingbay.xyz  
**Documentation:** https://huggingbay.xyz/docs/api

huggingbay-xyz Mirrors API is one of 109 APIs that [huggingbay-xyz](https://apis.io/providers/huggingbay-xyz/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 12 JSON Schema definitions. Tagged areas include Mirrors. The published artifact set on APIs.io includes an OpenAPI specification and 12 JSON Schemas.

The Mirrors API from huggingbay-xyz — 11 operation(s) for mirrors.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/artifacts/{id}/manifest` | Stable v1 hosted manifest alias |
| GET | `/api/v1/artifacts/{id}/peer-fallbacks` | Stable v1 reviewed peer fallback metadata |
| GET | `/api/v1/mirrors/hosted` | Stable v1 list of hosted Hugging Bay files |
| POST | `/api/v1/mirror-requests` | Request a reviewed Hugging Bay mirror for a public artifact |
| GET | `/api/v1/mirror-requests/{id}` | Fetch a public mirror request receipt/status document |
| GET | `/api/artifacts/{id}/distribution` | Fetch hosted, upstream, and reviewed peer-assisted distribution options |
| GET | `/api/artifacts/{id}/peer-fallbacks` | Fetch reviewed torrent/magnet fallback metadata for hosted files |
| POST | `/api/artifacts/{id}/decentralized-fallbacks` | Submit magnet metadata for reviewed peer-assisted fallback distribution |
| GET | `/api/mirror-requests/{id}` | Fetch a public mirror request receipt/status document |
| GET | `/api/mirrors` | List registered Hugging Bay mirror nodes and their health |
| POST | `/api/mirrors` | Register a reviewed public mirror node |
| PATCH | `/api/mirrors/{id}` | Update a mirror node health state |

## Machine-readable artifacts (13)

- **OpenAPI** — https://artifacts.apis.io/huggingbay-xyz/openapi/huggingbay-xyz-mirrors-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-public-dataset-inspection-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-request-intent-submission-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-run-card-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-request-intent-surface-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-public-evidence-surface-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-run-card-discovery-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-task-verification-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-memory-tool-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-bakeoff-tool-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-chat-completions-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-route-execution-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-task-execution-response-schema.json

## Other huggingbay-xyz APIs (12)

- [huggingbay-xyz A2a API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-a2a-api/)
- [huggingbay-xyz Account API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-account-api/)
- [huggingbay-xyz Accounts API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-accounts-api/)
- [huggingbay-xyz Agent Directory.json API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agent-directory-json-api/)
- [huggingbay-xyz Agent Docs API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agent-docs-api/)
- [huggingbay-xyz Agents API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agents-api/)
- [huggingbay-xyz Agents.json API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agents-json-api/)
- [huggingbay-xyz AGENTS.md API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agents-md-api/)
- [huggingbay-xyz Agents.txt API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agents-txt-api/)
- [huggingbay-xyz Analytics API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-analytics-api/)
- [huggingbay-xyz Answers API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-answers-api/)
- [huggingbay-xyz Artifacts API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-artifacts-api/)

## Tags

Mirrors

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-mirrors-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/huggingbay-xyz/.
