# huggingbay-xyz Library API

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

huggingbay-xyz Library 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 Library. The published artifact set on APIs.io includes an OpenAPI specification and 12 JSON Schemas.

The Library API from huggingbay-xyz — 12 operation(s) for library.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/account/reader-token` | Create a self-service reader token for persistent saves, collections, and… |
| GET | `/api/account/reader-tokens` | List reader tokens visible to the current account |
| DELETE | `/api/account/reader-tokens/{keyId}` | Revoke one reader token owned by the current account |
| GET | `/api/account/dashboard` | Fetch the current account's library, watchlist, token, and next-action dashboard |
| GET | `/api/account/recovery-kit` | Fetch copy-paste recovery instructions for reader-token, CLI, MCP, extension… |
| GET | `/api/library` | List the current authenticated principal's saved artifacts |
| POST | `/api/library` | Save an artifact to the current principal's library |
| DELETE | `/api/library` | Clear every saved artifact from the current principal's library |
| PUT | `/api/library/{artifactId}` | Idempotently save one artifact for the current principal |
| PATCH | `/api/library/{artifactId}` | Update collection metadata for one saved artifact |
| DELETE | `/api/library/{artifactId}` | Remove one artifact from the current principal's library |
| GET | `/api/saved-searches` | List the current authenticated principal's saved catalog searches and watchlists |
| POST | `/api/saved-searches` | Save a catalog search/watchlist for the current principal |
| DELETE | `/api/saved-searches` | Clear every saved catalog search/watchlist for the current principal |
| GET | `/api/saved-searches/alerts` | List bounded alert summaries for enabled saved catalog watchlists |
| PUT | `/api/saved-searches/{searchId}` | Idempotently save or update one catalog watchlist |
| DELETE | `/api/saved-searches/{searchId}` | Remove one saved search/watchlist from the current principal |
| PATCH | `/api/saved-searches/{searchId}/alert` | Enable, disable, mark seen, or configure delivery metadata for one saved-search… |
| GET | `/api/saved-searches/{searchId}/digest` | Return an agent-readable digest for one saved catalog search/watchlist |

## Machine-readable artifacts (13)

- **OpenAPI** — https://artifacts.apis.io/huggingbay-xyz/openapi/huggingbay-xyz-library-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

Library

---

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